刷新 refresh_token
收藏client_key 必须拥有 renew_refresh_token 权限。
接口说明
该接口用于刷新 refresh_token 的有效期。该接口适用于抖音授权。
注意事项
- 抖音的 OAuth API 以https://open.douyin.com/ 开头。
- 刷新操作需要在 refresh_token 过期前进行。
- 通过旧的 refresh_token 获取新的 refresh_token，调用后旧 refresh_token 会失效，新 refresh_token 有 30 天有效期。最多只能获取 5 次新的 refresh_token，5 次过后需要用户重新授权。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/oauth/renew_refresh_token/ |
| HTTP Method | POST |
请求参数
请求头
Content-Type必填String
示例：application/x-www-form-urlencoded
固定值 "application/x-www-form-urlencoded"
Body
client_key必填String
示例：tt10abc******
应用唯一标识
refresh_token必填String
示例：rft.a736b70544519999a6******
填写通过/oauth/access_token/ 获取到的 refresh_token 参数
请求示例
curl --location --request POST 'https://open.douyin.com/oauth/renew_refresh_token/' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'client_key=tt10abc******' \ --data-urlencode 'refresh_token=rft.a736b70544519999a6******'
响应参数
Body展开全部子属性
dataStruct
展开子属性
messageString
响应示例
正常响应示例异常响应示例
{ "data": { "description": "", "error_code": 0, "expires_in": "86400", "refresh_token": "refresh_token" }, "message": "success" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 10005 | 缺少参数 | 检查是否填写 client_key 和 refresh_token 参数，请求格式是否正确。 |
| 200 | 10004 | 权限不足 | 请申请 renew_refresh_token 权限。 |
| 200 | 10010 | refresh_token 过期 | token 已过期，请让用户重新授权。 |
| 200 | 10020 | 超过刷新次数限制 | 无法再刷新，请让用户重新授权。 |
