應用接入微信登錄-步步爲贏

博客轉移到個人站點:http://www.wangchengmeng.club/2018/02/01/%E5%BA%94%E7%94%A8%E6%8E%A5%E5%85%A5%E5%BE%AE%E4%BF%A1%E7%99%BB%E5%BD%95-%E6%AD%A5%E6%AD%A5%E4%B8%BA%E8%B5%A2/

歡迎來吐槽

接入微信登錄:

1、準備工作

1.在微信開放平臺https://open.weixin.qq.com/註冊成爲開發者。

2.在“管理中心”中創建一個移動應用,需“應用名稱、簡介、及28*28和108*108的PNG圖片各一張,且大小不超過300k”,點擊下一步,需“應用官網地址,應用簽名及包名”等信息,然後即可提交審覈。
說明:
應用簽名:可在微信開發平臺的資源中心》》資源下載》》中下載“簽名生成工具”,用戶獲取已經安裝到手機的第三方應用的簽名。輸入應用包名,即可獲得該應用的簽名值。

3.提交審覈後,在7個工作日內騰訊將給出審覈結果。(通常較快,幾個小時就可反饋結果)

2、微信登錄接入

微信登錄遵循協議Aouth2.0中的授權碼模式,先介紹一下Aouth2.0的流程:

處理流程

3、微信登錄的官方文檔將微信登錄分爲3個步驟:

第一步.請求code:

{
    // send oauth request 
     Final SendAuth.Req req = new SendAuth.Req();
     req.scope = "snsapi_userinfo";
     req.state = "wechat_sdk_demo_test";
     api.sendReq(req);
}

用這段代碼向微信開放平臺請求授權碼code,可拉起微信並打開授權登錄頁(前提是你安裝了微信應用並已登錄,未登錄的會引導你先登錄)下圖:

調起微信授權頁面

需要注意的情況:

1.如果微信授權頁不顯示,請檢查你的APP簽名是否和你在騰訊開放平臺的APP簽名一致,不一致可修改騰訊開放平臺中的APP簽名,修改後重裝微信或清除微信數據後重試。

2.在你的包名相應目錄下新建一個wxapi目錄,並在該wxapi目錄下新增一個WXEntryActivity類,該類繼承自Activity(例如應用程序的包名爲net.sourceforge,則新的包名爲:net.sourceforge.wxapi),此處應注意包名不要弄錯,新增類的名字必須爲WXEntryActivity。

返回說明

用戶點擊授權後,微信客戶端會被拉起,跳轉至授權界面,用戶在該界面點擊允許或取消,SDK通過SendAuth的Resp返回數據給調用方。回調WXEntryActivity中的onResp(BaseResp resp)方法,如下:

@Override
public void onResp(BaseResp resp) {
    int errorCode = resp.errCode;
    switch (errorCode) {
    case BaseResp.ErrCode.ERR_OK:
        //用戶同意
        String code = ((SendAuth.Resp) resp).code;
        break;
    case BaseResp.ErrCode.ERR_AUTH_DENIED:
        //用戶拒絕
        break;
    case BaseResp.ErrCode.ERR_USER_CANCEL:
        //用戶取消
        break;
    default:
        break;
    }
    ToastUtil.showMessageLong(this, resp.errStr);
}

客戶端收到授權碼後,向自己的服務器發起登錄請求,並附帶收到的授權碼。

服務端收到登錄請求,向微信開放平臺請求獲取access_token,微信開放平臺返回Json字符串:

第二步:通過code獲取access_token:

獲取第一步的code後,請求以下鏈接獲取access_token:

private String getAccessToken(String code) {
        String url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code";
        URI uri = URI.create(url);
        HttpClient client = new DefaultHttpClient();
        HttpGet get = new HttpGet(uri);
        HttpResponse response;
    try {
        response = client.execute(get);
        if (response.getStatusLine().getStatusCode() == 200) {
            HttpEntity entity = response.getEntity();

            BufferedReader reader = new BufferedReader(new InputStreamReader(entity.getContent(), "UTF-8"));
            StringBuilder sb = new StringBuilder();

            for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                sb.append(temp);
            }

            JSONObject object = new JSONObject(sb.toString().trim());
            accessToken = object.getString("access_token");
            openID = object.getString("openid");
            refreshToken = object.getString("refresh_token");
            expires_in = object.getLong("expires_in");
            return accessToken;
        }
    } catch (Exception e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    }
    return null;
}

參數說明

參數        是否必須        說明 
appid       是        應用唯一標識,在微信開放平臺提交應用審覈通過後獲得

secret      是      應用密鑰AppSecret,在微信開放平臺提交應用審覈通過後獲得

code        是       填寫第一步獲取的code參數

grant_type  是      填authorization_code回說明**

正確的返回:

{ 
"access_token":"ACCESS_TOKEN", 
"expires_in":7200, 
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID", 
"scope":"SCOPE",
"unionid":"o6_bmasdasdsad6_2sgVt7hMZOPfL"
}

  參數                              說明
access_token                    接口調用憑證
expires_in  access_token        接口調用憑證超時時間,單位(秒)
refresh_token                   用戶刷新access_token
openid                          授權用戶唯一標識
scope                           用戶授權的作用域,使用逗號(,)分隔
unionid          只有在用戶將公衆號綁定到微信開放平臺帳號後,纔會出現該字段。

錯誤返回樣例:

{"errcode":40029,"errmsg":"invalid code"}

第三步:通過access_token調用接口

獲取access_token後,進行接口調用,有以下前提:

access_token有效且未超時;
微信用戶已授權給第三方應用帳號相應接口作用域(scope)。

對於接口作用域(scope),能調用的接口有以下:

授權作用域(scope)             接口                接口說明
snsapi_base       /sns/oauth2/access_token     通過code換取              access_token、refresh_token和已授權scope
                    /sns/oauth2/refresh_token  刷新或續期access_token使用
                    /sns/auth                  檢查access_token有效性
snsapi_userinfo    /sns/userinfo               獲取用戶個人信息

其中snsapi_base屬於基礎接口,若應用已擁有其它scope權限,則默認擁有snsapi_base的權限。使用snsapi_base可以讓移動端網頁授權繞過跳轉授權登錄頁請求用戶授權的動作,直接跳轉第三方網頁帶上授權臨時票據(code),但會使得用戶已授權作用域(scope)僅爲snsapi_base,從而導致無法獲取到需要用戶授權才允許獲得的數據和基礎功能。

以獲取用戶信息爲例:

private void getUserInfo() {
        if (isAccessTokenIsInvalid() && System.currentTimeMillis() < expires_in) {
            String uri = "https://api.weixin.qq.com/sns/userinfo?access_token=" + accessToken + "&openid=" + openID;
            HttpClient client = new DefaultHttpClient();
            HttpGet get = new HttpGet(URI.create(uri));
            try {
                HttpResponse response = client.execute(get);
                if (response.getStatusLine().getStatusCode() == 200) {
                    BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "UTF-8"));
                    StringBuilder builder = new StringBuilder();
                    for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                        builder.append(temp);
                    }
                    JSONObject object = new JSONObject(builder.toString().trim());
                    String nikeName = object.getString("nickname");
                }
            } catch (Exception e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
        }
    }

微信重複登錄

假設用戶已經獲得授權,則下次登錄時只需要驗證access_token是否有效,無效則重新獲取授權,有效則無需重新獲得授權。

1.用戶向自己的服務器請求登錄,登錄方式爲微信登錄,附帶上次登錄返回的的access_token

2.服務器收到用戶的登錄請求,向微信開放平臺發送access_token是否有效的驗證請求如下:

private boolean isAccessTokenIsInvalid() {
        String url = "https://api.weixin.qq.com/sns/auth?access_token=" + accessToken + "&openid=" + openID;
        URI uri = URI.create(url);
        HttpClient client = new DefaultHttpClient();
        HttpGet get = new HttpGet(uri);
        HttpResponse response;
        try {
            response = client.execute(get);
            if (response.getStatusLine().getStatusCode() == 200) {
                HttpEntity entity = response.getEntity();
            BufferedReader reader = new BufferedReader(new InputStreamReader(entity.getContent(), "UTF-8"));
            StringBuilder sb = new StringBuilder();

            for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                sb.append(temp);
            }
            JSONObject object = new JSONObject(sb.toString().trim());
            int errorCode = object.getInt("errcode");
            if (errorCode == 0) {
                return true;
            }
        }
    } catch (Exception e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    }
    return false;
}

返回說明

正確的Json返回結果:
    { 
    "errcode":0,"errmsg":"ok"
    }

錯誤的Json返回示例:
    { 
    "errcode":40003,"errmsg":"invalid openid"
    }

如果access_token有效,服務端將信息返回給客戶端,客戶端成功登錄。

如果access_token無效,服務端向微信開放平臺發送刷新access_token的請求如下:

access_token是調用授權關係接口的調用憑證,由於access_token有效期(目前爲2個小時)較短,當access_token超時後,可以使用refresh_token進行刷新,access_token刷新結果有兩種:

1.若access_token已超時,那麼進行refresh_token會獲取一個新的access_token,新的超時時間; 
2.若access_token未超時,那麼進行refresh_token不會改變access_token,但超時時間會刷新,相當於續期access_token。

刷新token

private void refreshAccessToken() {
    String uri = "https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=" + ShareUtil.APP_ID + "&grant_type=refresh_token&refresh_token="
            + refreshToken;
    HttpClient client = new DefaultHttpClient();
    HttpGet get = new HttpGet(URI.create(uri));
    try {
        HttpResponse response = client.execute(get);
        if (response.getStatusLine().getStatusCode() == 200) {
            BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "UTF-8"));
            StringBuilder builder = new StringBuilder();
            for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                builder.append(temp);
            }
            JSONObject object = new JSONObject(builder.toString().trim());
            accessToken = object.getString("access_token");
            refreshToken = object.getString("refresh_token");
            openID = object.getString("openid");
            expires_in = object.getLong("expires_in");
        }
    } catch (Exception e) {
        // TODO Auto-generated catch block
        e.printStackTrace();
    }
}

正確的返回:

{ 
"access_token":"ACCESS_TOKEN", 
"expires_in":7200, 
"refresh_token":"REFRESH_TOKEN", 
"openid":"OPENID", 
"scope":"SCOPE" 
}
參數                    說明
access_token       接口調用憑證
expires_in        access_token接口調用憑證超時時間,單位(秒)
refresh_token     用戶刷新access_token
openid           授權用戶唯一標識
scope          用戶授權的作用域,使用逗號(,)分隔

錯誤返回樣例:

{
"errcode":40030,"errmsg":"invalid refresh_token"
}
發佈了49 篇原創文章 · 獲贊 38 · 訪問量 4萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章