getAccessToken__抖音开放平台

接口说明

access_token 是小游戏的全局唯一调用凭据，开发者调用小游戏支付时需要使用 access_token。access_token 的有效期为 2 个小时，需要定时刷新 access_token，重复获取会导致之前一次获取的 access_token 的有效期缩短为 5 分钟。

Bug & Tip

Tip: token 是小游戏级别 token，不要为每个用户单独分配一个 token，会导致 token 校验失败。建议每小时更新一次即可。
Tip: 原域名 https://developer.toutiao.com/api/apps/xxx 仍然可用，不过为了后续兼容性和可能的迁移，建议开发者更换到新的域名。
Tip: 为了保障应用的数据安全，只能在开发者服务器使用 AppSecret；开发者服务器不应该把会话密钥下发到小游戏，也不应该对外提供这个密钥。如果小游戏存在泄露 AppSecret 或会话密钥的问题，字节小游戏平台将有可能下架该小游戏，并暂停该小游戏相关服务。

基本信息

名称	描述
HTTP URL	https://minigame.zijieapi.com/mgplatform/api/apps/v2/token
HTTP Method	POST
Scope	open.ttgame.mgplatform

请求头

名称	字段类型	是否必填	示例	描述
content-type	String	是	application/json	固定值"application/json"

请求参数

Body

名称	字段类型	是否必填	示例	描述
appid	String	是		小游戏 ID
grant_type	String	是	client_credential	获取 access_token 时值为 client_credential
secret	String	是		小游戏的 APP Secret，可以在「开发者后台->开发管理->开发设置」获取

请求示例

curl -X POST \
 -H "content-type: application/json" \
 -d '{"appid":"tt**********65","secret":"98*******************92","grant_type":"client_credential"}' \
 https://minigame.zijieapi.com/mgplatform/api/apps/v2/token

响应参数

Body

名称	字段类型	是否必填	描述
data	Struct	是
err_no	Int64	是	错误码
err_tips	String	是	错误信息

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "success",
  "data": {
    "access_token": "0801121***********",
    "expires_in": 7200
  }
}

异常响应示例

{
  "err_no": 40017,
  "err_tips": "bad secret",
  "data": {
    "access_token": "",
    "expires_in": 0
  }
}

错误码

http状态码	错误码	错误码描述
200	0	请求成功
200	-1	系统错误
200	40015	appid 错误
200	40017	secret 错误
200	40020	grant_type 不是 client_credential

getAccessToken在线调试

接口说明

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

getAccessToken