視頻號小店獲取AccessToken
獲取AccessToken
本接口應在服務器端調用,詳細說明參見服務端API。
獲取小店全局唯一后臺接口調用憑據(jù)(access_token)。調用絕大多數(shù)后臺接口時都需使用 access_token,開發(fā)者需要進行妥善保存。
接口調用請求說明
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
請求參數(shù)
屬性類型默認值必填說明
grant_typestring是填寫 client_credential
appidstring是小店唯一憑證,即 小店ID,可在「視頻號小店 - 服務市場 - 自研」頁中獲得。(需要已完成店鋪開通,且?guī)ぬ枦]有異常狀態(tài))
secretstring是小店唯一憑證密鑰,即 小店Secret,獲取方式同 小店ID
返回值
Object
返回的 JSON 數(shù)據(jù)包
屬性類型說明
access_tokenstring獲取到的憑證
expires_innumber憑證有效時間,單位:秒。目前是7200秒之內的值。
errcodenumber錯誤碼
errmsgstring錯誤信息
errcode 的合法值
值說明最低版本
-1系統(tǒng)繁忙,此時請開發(fā)者稍候再試
0請求成功
40001AppSecret 錯誤或者 AppSecret 不屬于這個小店,請開發(fā)者確認 AppSecret 的正確性
40002請確保 grant_type 字段值為 client_credential
40013不合法的 AppID,請開發(fā)者檢查 AppID 的正確性,避免異常字符,注意大小寫
返回數(shù)據(jù)示例
正常返回
{
"access_token": "ACCESS_TOKEN",
"expires_in": 7200
}
錯誤時返回
{
"errcode": 40013,
"errmsg": "invalid appid"
}
access_token 的存儲與更新
access_token 的存儲至少要保留 512 個字符空間;
access_token 的有效期目前為 2 個小時 ,需定時刷新,重復獲取將導致上次獲取的 access_token 失效;
建議開發(fā)者使用中控服務器統(tǒng)一獲取和刷新 access_token,其他業(yè)務邏輯服務器所使用的 access_token 均來自于該中控服務器,不應該各自去刷新,否則容易造成沖突,導致 access_token 覆蓋而影響業(yè)務;
access_token 的有效期通過返回的 expires_in 來傳達,目前是7200秒之內的值,中控服務器需要根據(jù)這個有效時間提前去刷新。在刷新過程中,中控服務器可對外繼續(xù)輸出的老 access_token,此時公眾平臺后臺會保證在5分鐘內,新老 access_token 都可用,這保證了第三方業(yè)務的平滑過渡;
access_token 的有效時間可能會在未來有調整,所以中控服務器不僅需要內部定時主動刷新,還需要提供被動刷新 access_token 的接口,這樣便于業(yè)務服務器在 API 調用獲知 access_token 已超時的情況下,可以觸發(fā) access_token 的刷新流程。