微信-小程序-開發文檔-服務端-接口調用憑證:auth.getAccessToken


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


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM