獲取穩(wěn)定版接口調(diào)用憑據(jù)

接口說明

接口英文名

getStableAccessToken

功能描述

• 獲取公眾號全局后臺接口調(diào)用憑據(jù)，有效期最長為7200s，開發(fā)者需要進(jìn)行妥善保存；
• 有兩種調(diào)用模式: 1. 普通模式，access_token 有效期內(nèi)重復(fù)調(diào)用該接口不會更新 access_token，絕大部分場景下使用該模式；2. 強制刷新模式，會導(dǎo)致上次獲取的 access_token 失效，并返回新的 access_token；
• 該接口調(diào)用頻率限制為 1萬次 每分鐘，每天限制調(diào)用 50w 次；
• 與獲取Access token獲取的調(diào)用憑證完全隔離，互不影響。該接口僅支持 POST JSON 形式的調(diào)用；

調(diào)用方式

HTTPS 調(diào)用

POST https://api.weixin.qq.com/cgi-bin/stable_token 

請求參數(shù)

返回參數(shù)

其他說明

access_token 的存儲與更新

• access_token 的存儲空間至少要保留 512 個字符；
• 建議開發(fā)者僅在access_token 泄漏時使用強制刷新模式，該模式限制每天20次?？紤]到數(shù)據(jù)安全，連續(xù)使用該模式時，請保證調(diào)用時間隔至少為30s，否則不會刷新；
• 在普通模式調(diào)用下，平臺會提前5分鐘更新access_token，即在有效期倒計時5分鐘內(nèi)發(fā)起調(diào)用會獲取新的access_token。在新舊access_token交接之際，平臺會保證在5分鐘內(nèi)，新舊access_token都可用，這保證了用戶業(yè)務(wù)的平滑過渡； 根據(jù)此特性可知，任意時刻發(fā)起調(diào)用獲取到的 access_token 有效期至少為 5 分鐘，即expires_in >= 300；

最佳實踐

• 在使用獲取Access token時，平臺建議開發(fā)者使用中控服務(wù)來統(tǒng)一獲取和刷新access_token。有此成熟方案的開發(fā)者依然可以復(fù)用方案并通過普通模式來調(diào)用本接口，另外請將發(fā)起接口調(diào)用的時機設(shè)置為上次獲取到的access_token有效期倒計時5分鐘之內(nèi)即可；
• 根據(jù)以上特性，為減少其他開發(fā)者構(gòu)建中控服務(wù)的開發(fā)成本，在普通調(diào)用模式下，平臺建議開發(fā)者將每次獲取的access_token 在本地建立中心化存儲使用，無須考慮并行調(diào)用接口時導(dǎo)致意外情況發(fā)生，僅須保證至少每5分鐘發(fā)起一次調(diào)用并覆蓋本地存儲。同時，該方案也支持各業(yè)務(wù)獨立部署使用，即無須中心化存儲也可以保證服務(wù)正常運行；

access_token 泄漏緊急處理

• 使用強制刷新模式以間隔30s發(fā)起兩次調(diào)用可將已經(jīng)泄漏的 access_token立即失效，同時正常的業(yè)務(wù)請求可能會返回錯誤碼40001(access_token 過期)，請妥善使用該策略。其次，需要立即排查泄漏原因，加以修正，必要時可以考慮重置 appsecret；

調(diào)用示例

示例說明: 普通模式，獲取當(dāng)前有效調(diào)用憑證

請求數(shù)據(jù)示例

POST https://api.weixin.qq.com/cgi-bin/stable_token

請求示例1（不傳遞force_refresh，默認(rèn)值為false）:

{
    "grant_type": "client_credential",
    "appid": "APPID",
    "secret": "APPSECRET"
}

請求示例2（設(shè)置force_refresh為false）:

{
    "grant_type": "client_credential",
    "appid": "APPID",
    "secret": "APPSECRET",
    "force_refresh": false
} 

返回數(shù)據(jù)示例

返回示例1:

{
    "access_token":"ACCESS_TOKEN",
    "expires_in":7200
}

返回示例2:

{
    "access_token":"ACCESS_TOKEN",
    "expires_in":345 
} 

示例說明: 強制刷新模式，慎用，連續(xù)使用需要至少間隔30s

請求數(shù)據(jù)示例

POST https://api.weixin.qq.com/cgi-bin/stable_token

{
    "grant_type": "client_credential",
    "appid": "APPID",
    "secret": "APPSECRET",
    "force_refresh": true
} 

返回數(shù)據(jù)示例

{
    "access_token":"ACCESS_TOKEN",
    "expires_in":7200
} 

錯誤碼