https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

引數說明

返回說明

正確的返回：

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

錯誤返回樣例：

{"errcode":40030,"errmsg":"invalid refresh_token"}

注意：

1、Appsecret 是應用介面使用金鑰，洩漏後將可能導致應用資料洩漏、應用的使用者資料洩漏等高風險後果；儲存在客戶端，極有可能被惡意竊取（如反編譯獲取Appsecret）；

2、access_token 為使用者授權第三方應用發起介面呼叫的憑證（相當於使用者登入態），儲存在客戶端，可能出現惡意獲取access_token 後導致的使用者資料洩漏、使用者微信相關介面功能被惡意發起等行為；

3、refresh_token 為使用者授權第三方應用的長效憑證，僅用於重新整理access_token，但洩漏後相當於access_token 洩漏，風險同上。

建議將secret、使用者資料（如access_token）放在App雲端伺服器，由雲端中轉介面呼叫請求。

第三步：通過access_token呼叫介面

獲取access_token後，進行介面呼叫，有以下前提：

1. 1. access_token有效且未超時；

2. 2. 微信使用者已授權給第三方應用帳號相應介面作用域（scope）。

對於介面作用域（scope），能呼叫的介面有以下：

其中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. 網站內嵌二維碼微信登入JS程式碼中style欄位作用？

答：第三方頁面顏色風格可能為淺色調或者深色調，若第三方頁面為淺色背景，style欄位應提供"black"值（或者不提供，black為預設值），則對應的微信登入文字樣式為黑色。相關效果如下：

若提供"white"值，則對應的文字描述將顯示為白色，適合深色背景。相關效果如下：

4.網站內嵌二維碼微信登入JS程式碼中href欄位作用？

答：如果第三方覺得微信團隊提供的預設樣式與自己的頁面樣式不匹配，可以自己提供樣式檔案來覆蓋預設樣式。舉個例子，如第三方覺得預設二維碼過大，可以提供相關css樣式檔案，並把連結地址填入href欄位

.impowerBox .qrcode {width: 200px;}
.impowerBox .title {display: none;}
.impowerBox .info {width: 200px;}
.status_icon {display：none}
.impowerBox .status {text-align: center;} 

相關效果如下：

通過code獲取access_token

介面說明

通過code獲取access_token的介面。

請求說明

http請求方式: GET

https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

引數說明

返回說明

正確的返回：

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

錯誤返回樣例：

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

重新整理或續期access_token使用

介面說明

access_token是呼叫授權關係介面的呼叫憑證，由於access_token有效期（目前為2個小時）較短，當access_token超時後，可以使用refresh_token進行重新整理，access_token重新整理結果有兩種：

1. 1. 若access_token已超時，那麼進行refresh_token會獲取一個新的access_token，新的超時時間；

2. 2.若access_token未超時，那麼進行refresh_token不會改變access_token，但超時時間會重新整理，相當於續期access_token。

refresh_token擁有較長的有效期（30天），當refresh_token失效的後，需要使用者重新授權。

請求方法

使用/sns/oauth2/access_token介面獲取到的refresh_token進行以下介面呼叫：

http請求方式: GET

https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

引數說明

返回說明

正確的返回：

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

錯誤返回樣例：

{
"errcode":40030,"errmsg":"invalid refresh_token"
}

介面說明

檢驗授權憑證（access_token）是否有效

請求說明

http請求方式: GET

https://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID

引數說明

返回說明

正確的Json返回結果：

{ 
"errcode":0,"errmsg":"ok"
}

錯誤的Json返回示例:

{ 
"errcode":40003,"errmsg":"invalid openid"
}

獲取使用者個人資訊（UnionID機制）

介面說明

此介面用於獲取使用者個人資訊。開發者可通過OpenID來獲取使用者基本資訊。特別需要注意的是，如果開發者擁有多個移動應用、網站應用和公眾帳號，

可通過獲取使用者基本資訊中的unionid來區分使用者的唯一性，因為只要是同一個微信開放平臺帳號下的移動應用、網站應用和公眾帳號，使用者的unionid是唯一的。換句話說，同一使用者，對同一個微信開放平臺下的不同應用，unionid是相同的。

請求說明

http請求方式: GET

https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID

引數說明

返回說明

正確的Json返回結果：

{ 
"openid":"OPENID",
"nickname":"NICKNAME",
"sex":1,
"province":"PROVINCE",
"city":"CITY",
"country":"COUNTRY",
"headimgurl": "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
"privilege":[
"PRIVILEGE1", 
"PRIVILEGE2"
],
"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"

}

錯誤的Json返回示例:

{ 
"errcode":40003,"errmsg":"invalid openid"
}

呼叫頻率限制