auth.getStableAccessToken

接口说明

获取小游戏全局后台接口调用凭据，有效期最长为 7200 秒。开发者需要缓存 access_token，用于后续接口的调用。

接口地址

国内：

POST https://cloud-miniapp.tapapis.cn/auth/v1/stable-token

国际：

POST https://cloud-miniapp.tapapis.com/auth/v1/stable-token

请求参数

属性	类型	默认值	必填	说明
appid	string		是	小游戏 ID
secret	string		是	小游戏密钥
grant_type	string	client_credential	是	授权类型，固定为 client_credential
force_refresh	boolean	false	否	是否强制刷新 access_token

force_refresh 参数说明

• force_refresh=false（默认模式），access_token 有效期内重复调用该接口不会更新 access_token，绝大部分场景下使用该模式
• force_refresh=true（强制刷新模式），会导致上次获取的 access_token 失效，并返回新的 access_token

返回结果

正常返回

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

属性	类型	说明
access_token	string	获取到的凭证
expires_in	number	凭证有效时间，单位：秒

错误返回

{
  "errcode": 40013,
  "errmsg": "invalid appid"
}

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息

错误码

错误码	说明
1045011	API 调用太频繁，请稍候再试

最佳实践

• access_token 应该全局存储与更新，频繁刷新 access_token 会导致调用受限
• 建议提前 5-10 分钟刷新 access_token，避免临近过期时可能出现的请求失败

示例代码

请求示例

POST https://cloud-miniapp.tapapis.cn/auth/v1/stable-token
Content-Type: application/json

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

返回示例

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