ylbtech-微信-小程序-開發文檔-服務端-接口調用憑證:auth.getAccessToken |
1.返回頂部 |
1、
auth.getAccessToken
本接口應在服務器端調用,詳細說明參見服務端API。
獲取小程序全局唯一后台接口調用憑據(access_token
)。調調用絕大多數后台接口時都需使用 access_token,開發者需要進行妥善保存。
請求地址
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
請求參數
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
grant_type | string | 是 | 填寫 client_credential | |
appid | string | 是 | 小程序唯一憑證,即 AppID,可在「微信公眾平台 - 設置 - 開發設置」頁中獲得。(需要已經成為開發者,且帳號沒有異常狀態) | |
secret | string | 是 | 小程序唯一憑證密鑰,即 AppSecret,獲取方式同 appid |
返回值
Object
返回的 JSON 數據包
屬性 | 類型 | 說明 |
---|---|---|
access_token | string | 獲取到的憑證 |
expires_in | number | 憑證有效時間,單位:秒。目前是7200秒之內的值。 |
errcode | number | 錯誤碼 |
errmsg | string | 錯誤信息 |
errcode 的合法值
值 | 說明 | 最低版本 |
---|---|---|
-1 | 系統繁忙,此時請開發者稍候再試 | |
0 | 請求成功 | |
40001 | AppSecret 錯誤或者 AppSecret 不屬於這個小程序,請開發者確認 AppSecret 的正確性 | |
40002 | 請確保 grant_type 字段值為 client_credential | |
40013 | 不合法的 AppID,請開發者檢查 AppID 的正確性,避免異常字符,注意大小寫 |
返回數據示例
正常返回
{"access_token":"ACCESS_TOKEN","expires_in":7200}
錯誤時返回
{"errcode":40013,"errmsg":"invalid appid"}
access_token 的存儲與更新
access_token
的存儲至少要保留 512 個字符空間;access_token
的有效期目前為 2 個小時,需定時刷新,重復獲取將導致上次獲取的access_token
失效;- 建議開發者使用中控服務器統一獲取和刷新
access_token
,其他業務邏輯服務器所使用的access_token
均來自於該中控服務器,不應該各自去刷新,否則容易造成沖突,導致access_token
覆蓋而影響業務; access_token
的有效期通過返回的expire_in
來傳達,目前是7200秒之內的值,中控服務器需要根據這個有效時間提前去刷新。在刷新過程中,中控服務器可對外繼續輸出的老access_token
,此時公眾平台后台會保證在5分鍾內,新老access_token
都可用,這保證了第三方業務的平滑過渡;access_token
的有效時間可能會在未來有調整,所以中控服務器不僅需要內部定時主動刷新,還需要提供被動刷新access_token
的接口,這樣便於業務服務器在API調用獲知access_token
已超時的情況下,可以觸發access_token
的刷新流程。
詳情可參考微信公眾平台文檔 《獲取access_token》
在線調試
開發者可以使用網頁調試工具調試該接口
2、
2.返回頂部 |
3.返回頂部 |
4.返回頂部 |
5.返回頂部 |
1、
2、
6.返回頂部 |
![]() |
作者:ylbtech 出處:http://ylbtech.cnblogs.com/ 本文版權歸作者和博客園共有,歡迎轉載,但未經作者同意必須保留此段聲明,且在文章頁面明顯位置給出原文連接,否則保留追究法律責任的權利。 |