商城系統(tǒng) 注冊

視頻號小店獲取AccessToken

2023-03-16|HiShop
導讀:獲取AccessToken 本接口應在服務器端調用,詳細說明參見服務端API。 獲取小店全局唯一后臺接口調用憑據(jù)(access_token)。調用絕大多數(shù)后臺接口時都需使用 access_token,開發(fā)者需要進行妥善保...

  獲取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 的刷新流程。

電話咨詢 預約演示 0元開店