QQ小游戲 接口調(diào)用憑證

2020-07-16 16:03 更新

getAccessToken

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。

獲取小程序全局唯一后臺接口調(diào)用憑據(jù)(access_token)。調(diào)調(diào)用絕大多數(shù)后臺接口時都需使用 access_token,開發(fā)者需要進(jìn)行妥善保存。

請求地址

GET https://api.q.qq.com/api/getToken?grant_type=client_credential&appid=APPID&secret=APPSECRET

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
grant_type string 填寫 client_credential
appid string 小程序唯一憑證,即 AppID,可在「QQ小程序管理平臺 - 設(shè)置 - 開發(fā)設(shè)置」頁中獲得。(需要已經(jīng)成為開發(fā)者,且?guī)ぬ枦]有異常狀態(tài))
secret string 小程序唯一憑證密鑰,即 AppSecret,獲取方式同 appid

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
access_token string 獲取到的憑證
expires_in number 憑證有效時間,單位:秒。目前是7200秒之內(nèi)的值。
errcode number 錯誤碼
errmsg string 錯誤信息

errcode 的合法值

說明
-1 系統(tǒng)繁忙,此時請開發(fā)者稍候再試
0 請求成功
40001 AppSecret 錯誤或者 AppSecret 不屬于這個小程序,請開發(fā)者確認(rèn) 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 個小時,需定時刷新,重復(fù)獲取將導(dǎo)致上次獲取的 access_token 失效;
  • 建議開發(fā)者使用中控服務(wù)器統(tǒng)一獲取和刷新 access_token,其他業(yè)務(wù)邏輯服務(wù)器所使用的 access_token 均來自于該中控服務(wù)器,不應(yīng)該各自去刷新,否則容易造成沖突,導(dǎo)致 access_token 覆蓋而影響業(yè)務(wù);
  • access_token 的有效期通過返回的 expire_in 來傳達(dá),目前是7200秒之內(nèi)的值,中控服務(wù)器需要根據(jù)這個有效時間提前去刷新。在刷新過程中,中控服務(wù)器可對外繼續(xù)輸出的老 access_token,此時公眾平臺后臺會保證在5分鐘內(nèi),新老 access_token 都可用,這保證了第三方業(yè)務(wù)的平滑過渡;
  • access_token 的有效時間可能會在未來有調(diào)整,所以中控服務(wù)器不僅需要內(nèi)部定時主動刷新,還需要提供被動刷新 access_token 的接口,這樣便于業(yè)務(wù)服務(wù)器在API調(diào)用獲知 access_token 已超時的情況下,可以觸發(fā) access_token 的刷新流程
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號