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 |
| 权限要求 | access_token 是小游戏的全局唯一调用凭据，开发者调用小游戏支付时需要使用 access_token。access_token 的有效期为 2 个小时，需要定时刷新 access_token，重复获取会导致之前一次获取的 access_token 的有效期缩短为 5 分钟。 |
请求参数
请求头
content-type必填String
固定值"application/json"
Body
appid必填String
小游戏 ID
secret必填String
小游戏的 APP Secret，可以在开发者后台获取
grant_typeString
获取 access_token 时值为 client_credential
请求示例
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 } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 0 | 请求成功 | |
| 200 | -1 | 系统错误 | |
| 200 | 40015 | appid 错误 | |
| 200 | 40017 | secret 错误 | |
| 200 | 40020 | grant_type 不是 client_credential |
