genStableAccessToken
收藏接口说明
区别于 getAccessToken OpenAPI在每次调用时会生成新的access_token，并将上次获取的token有效期设置为5分钟（需要开发者构建服务实现定时刷新逻辑），getStableAccessToken OpenAPI用于获取在有效期内稳定不变的access_token，支持开发者任意服务需要时直接调用获取而不用实现单独的定时刷新逻辑集中管理。有两种模式：
- 普通模式：在 access_token 有效期内重复调用该接口不会更新 access_token，会直接返回当前值
- 强制刷新模式：调用时会让当前有效期内的 access_token 立即失效，重新生成新的 access_token
开发者自己需妥善保护稳定版的 access_token 避免泄露，若发现有泄露需及时使用强制刷新模式生成新的 access_token。
使用限制
普通模式，单个appid限制每分钟最多请求1w次，每天50w次；强制刷新模式，单个 appid 限制每天最多调用20次。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://minigame.zijieapi.com/mgplatform/api/apps/stable_token |
| HTTP Method | POST |
| Scope | open.ttgame.mgplatform |
| 权限要求 | 生成在有效期内稳定不变的接口调用凭据 |
请求参数
请求头
content-type必填String
示例：application/json
固定值"application/json"
Body
appid必填String
小游戏开发者账号唯一凭证即AppID，可在开发者平台获取
grant_type必填String
授权类型，传固定值 client_credential
secret必填String
小游戏开发者账号唯一凭证的密钥即AppSecret，可在开发者平台获取
force_refreshBool
是否强制刷新，默认使用 false
请求示例
curl --location --request POST 'https://minigame.zijieapi.com/mgplatform/api/apps/stable_token' \ --header 'content-type: application/json' \ --data '{"appid":"ttf5d6836abcdeffbc02","secret":"eab8re3fdsaur3nf8789x0feeye","grant_type":"client_credential","force_refresh":false}'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String
错误信息
err_no必填Int32
错误码
log_id必填String
请求日志ID
响应示例
正常响应示例异常响应示例
{ "data": { "access_token": "080112184745453432574e56596b44504a385579365368416b413d3d", "expires_in": 7200 }, "err_msg": "", "err_no": 0, "log_id": "20250520193036E7194E7CB37873E5C680" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005139 | 请求过于频繁，请稍后再试 | 等待一段时间后再请求 |
| 200 | 28001038 | 参数错误 | 仔细检查appid、secret、grant_type等参数是否合法 |
| 200 | 28001005 | 系统内部错误 | 重试请求或联系oncall排查 |
