https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317851&token=&lang=zh_CN
准備工作
移動應用微信登錄是基於OAuth2.0協議標准 構建的微信OAuth2.0授權登錄系統。
在進行微信OAuth2.0授權登錄接入之前，在微信開放平台注冊開發者帳號，並擁有一個已審核通過的移動應用，並獲得相應的AppID和AppSecret，申請微信登錄且通過審核后，可開始接入流程。
1、目前移動應用上微信登錄只提供原生的登錄方式，需要用戶安裝微信客戶端才能配合使用。
2、對於Android應用，建議總是顯示微信登錄按鈕，當用戶手機沒有安裝微信客戶端時，請引導用戶下載安裝微信客戶端。
3、對於iOS應用，考慮到iOS應用商店審核指南中的相關規定，建議開發者接入微信登錄時，先檢測用戶手機是否已安裝微信客戶端（使用sdk中isWXAppInstalled函數 ），對未安裝的用戶隱藏微信登錄按鈕，只提供其他登錄方式（比如手機號注冊登錄、游客登錄等）。
授權流程說明
微信OAuth2.0授權登錄讓微信用戶使用微信身份安全登錄第三方應用或網站，在微信用戶授權登錄已接入微信OAuth2.0的第三方應用后，第三方可以獲取到用戶的接口調用憑證（access_token），通過access_token可以進行微信開放平台授權關系接口調用，從而可實現獲取微信用戶基本開放信息和幫助用戶實現基礎開放功能等。
微信OAuth2.0授權登錄目前支持authorization_code模式，適用於擁有server端的應用授權。該模式整體流程為：
1. 第三方發起微信授權登錄請求，微信用戶允許授權第三方應用后，微信會拉起應用或重定向到第三方網站，並且帶上授權臨時票據code參數；
2. 通過code參數加上AppID和AppSecret等，通過API換取access_token；
3. 通過access_token進行接口調用，獲取用戶基本數據資源或幫助用戶實現基本操作。
獲取access_token時序圖：
第一步：請求CODE
移動應用微信授權登錄
開發者需要配合使用微信開放平台提供的SDK進行授權登錄請求接入。正確接入SDK后並擁有相關授權域（scope，什么是授權域？）權限后，開發者移動應用會在終端本地拉起微信應用進行授權登錄，微信用戶確認后微信將拉起開發者移動應用，並帶上授權臨時票據（code）。
iOS平台應用授權登錄接入代碼示例（請參考iOS接入指南）：
-(void)sendAuthRequest
{
//構造SendAuthReq結構體
SendAuthReq* req =[[[SendAuthReq alloc]init]autorelease];
req.scope = @"snsapi_userinfo";
req.state = @"123";
//第三方向微信終端發送一個SendAuthReq消息結構
[WXApi sendReq:req];
}
Android平台應用授權登錄接入代碼示例（請參考Android接入指南）：
{
// send oauth request
Final SendAuth.Req req = new SendAuth.Req();
req.scope = "snsapi_userinfo";
req.state = "wechat_sdk_demo_test";
api.sendReq(req);
}
參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| appid | 是 | 應用唯一標識，在微信開放平台提交應用審核通過后獲得 |
| scope | 是 | 應用授權作用域，如獲取用戶個人信息則填寫snsapi_userinfo（ 什么是授權域？ ） |
| state | 否 | 用於保持請求和回調的狀態，授權請求后原樣帶回給第三方。該參數可用於防止csrf攻擊（跨站請求偽造攻擊），建議第三方帶上該參數，可設置為簡單的隨機數加session進行校驗 |
返回示例：
appid: wxd477edab60670232
scope: snsapi_userinfo
state: wechat_sdk_demo
可拉起微信打開授權登錄頁：
返回說明
用戶點擊授權后，微信客戶端會被拉起，跳轉至授權界面，用戶在該界面點擊允許或取消，SDK通過SendAuth的Resp返回數據給調用方。
| 返回值 | 說明 |
|---|---|
| ErrCode | ERR_OK = 0(用戶同意) ERR_AUTH_DENIED = -4（用戶拒絕授權） ERR_USER_CANCEL = -2（用戶取消） |
| code | 用戶換取access_token的code，僅在ErrCode為0時有效 |
| state | 第三方程序發送時用來標識其請求的唯一性的標志，由第三方程序調用sendReq時傳入，由微信終端回傳，state字符串長度不能超過1K |
| lang | 微信客戶端當前語言 |
| country | 微信用戶當前國家信息 |
第二步：通過code獲取access_token
獲取第一步的code后，請求以下鏈接獲取access_token：
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| 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 | 當且僅當該移動應用已獲得該用戶的userinfo授權時，才會出現該字段 |
錯誤返回樣例：
{"errcode":40029,"errmsg":"invalid code"}
刷新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。
refresh_token擁有較長的有效期（30天），當refresh_token失效的后，需要用戶重新授權。
請求方法
獲取第一步的code后，請求以下鏈接進行refresh_token：
https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN
參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| appid | 是 | 應用唯一標識 |
| grant_type | 是 | 填refresh_token |
| refresh_token | 是 | 填寫通過access_token獲取到的refresh_token參數 |
返回說明
正確的返回：
{
"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"}
注意：
1、Appsecret 是應用接口使用密鑰，泄漏后將可能導致應用數據泄漏、應用的用戶數據泄漏等高風險后果；存儲在客戶端，極有可能被惡意竊取（如反編譯獲取Appsecret）；
2、access_token 為用戶授權第三方應用發起接口調用的憑證（相當於用戶登錄態），存儲在客戶端，可能出現惡意獲取access_token 后導致的用戶數據泄漏、用戶微信相關接口功能被惡意發起等行為；
3、refresh_token 為用戶授權第三方應用的長效憑證，僅用於刷新access_token，但泄漏后相當於access_token 泄漏，風險同上。
建議將Appsecret、用戶數據（如access_token）放在App雲端服務器，由雲端中轉接口調用請求。
第三步：通過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，從而導致無法獲取到需要用戶授權才允許獲得的數據和基礎功能。
接口調用方法可查閱《微信授權關系接口調用指南》
F.A.Q
1. 什么是授權臨時票據（code）？
答：第三方通過code進行獲取access_token的時候需要用到，code的超時時間為10分鍾，一個code只能成功換取一次access_token即失效。code的臨時性和一次保障了微信授權登錄的安全性。第三方可通過使用https和state參數，進一步加強自身授權登錄的安全性。
2. 什么是授權作用域（scope）？
答：授權作用域（scope）代表用戶授權給第三方的接口權限，第三方應用需要向微信開放平台申請使用相應scope的權限后，使用文檔所述方式讓用戶進行授權，經過用戶授權，獲取到相應access_token后方可對接口進行調用。
3.開放平台移動應用微信登錄目前是否收費？
答：“微信登錄”和第三方網站共享微信龐大的用戶價值，同時為微信用戶提供更便捷服務和更優質內容，實現雙向共贏，目前不收取任何費用。