- 小程序 OpenAPI SDK 总览
- OpenAPI 简介
- 用户登录态签名
- 签名算法
- 联合授权
- 接口调用凭证
- 登录
- 小程序码与小程序链接
- Web 化接入
- 私信和群聊
- 解决方案
- 线索组件
- 隐私协议
- 视频能力
- 搜索能力
- 任务能力
- 电商
- 生活服务
- 短剧行业
- 用户信息
- 分享
- 客服
- 交易工具
- 小程序券
- 交易系统
- 素材库
- 内容安全
- 泛知识
- 担保支付
- 评价
- 其它
- 订阅消息
- 小程序推广计划
- 挂载
- 分发
- 数据分析
- 服务类目
- 直播间能力
- 抖音开放能力
- 能力申请
- 页面结构自定义
- 普通二维码绑定
- 抖音号绑定
- 流量主
- 抖店绑定
刷新授权调用凭证
收藏
我的收藏接口说明
该接口用于刷新 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 | |
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
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
data | Struct | 否 | ||
message | String | 否 |
响应示例
正常响应示例
{
"data": {
"description": "",
"error_code": 0,
"expires_in": "86400",
"refresh_token": "refresh_token"
},
"message": "success"
}
异常响应示例
{
"data": {
"captcha": "",
"desc_url": "",
"description": "scope权限非法",
"error_code": 10004
},
"message": "error"
}
错误码
http状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 10005 | 缺少参数 | 检查是否填写 client_key 和 refresh_token 参数,请求格式是否正确。 |
200 | 10004 | 权限不足 | 请申请 renew_refresh_token 权限。 |
200 | 10010 | refresh_token 过期 | token 已过期,请让用户重新授权。 |
200 | 10020 | 超过刷新次数限制 | 无法再刷新,请让用户重新授权。 |
该文档是否有帮助?
点击纠错