| 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/ 本文版權歸作者和博客園共有,歡迎轉載,但未經作者同意必須保留此段聲明,且在文章頁面明顯位置給出原文連接,否則保留追究法律責任的權利。 |
