BusinessToken 刷新
收藏接口说明
经营 Token 是可以由开发者自行签发的一种能力调用凭证，在经营 Token 过期后，可以使用 BusinessToken 刷新能力获取一个新的有效凭证。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/oauth/refresh_biz_token/ |
| HTTP Method | POST |
| Scope | ma.business_token |
请求参数
请求头
content-type必填String
示例：application/json
固定值"application/json"
Body
client_keyString
示例：tt*********01
抖音开发平台接入方标识，小程序调用时填入 AppID
client_secretString
示例：d0218aaf39*********672
接入方密钥，可以从
开发-开发配置-Webhook 页面的 Webhook Secret 位置获取
refresh_tokenString
示例：bus_rft.b48411*********BReVe3dsqw63OTrkV7hALvQVzRg
获取经营 Token 时，一同返回的刷新 Token。
请求示例
curl --location 'https://open.douyin.com/oauth/refresh_biz_token/' \ --header 'Content-Type: application/json' \ --data '{ "client_key": "tt88*********a38f01", "client_secret": "d0218aaf399*********9ef92bc84672", "refresh_token": "bus_rft.b48411*********BReVe3dsqw63OTrkV7hALvQVzRg" }'
响应参数
Body展开全部子属性
dataStruct
展开子属性
error_codeInt64
messageString
响应示例
正常响应示例异常响应示例
{ "biz_token": "bus_act.3c2f5cc363d5c464e509c066*********oDYf3Fmzl6ztOYr", "biz_expires_in": 2592000, "biz_refresh_token": "bus_rft.537b533773845107214b*********lwiBOqil5xceQ4MMI", "biz_refresh_expires_in": 3153600, }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001007 | 参数不合法 | 重新检查入参，确认 client_secret 与应用对应 |
| 200 | 29002002 | ClientKey不合法 | 检查 Client Key 字段入参，确认应用当前状态正常 |
| 200 | 28001005 | 系统内部错误，请重试 | 系统内部错误，请重试 |
