刷新用户授权调用凭证
收藏接口说明
该接口用于刷新 access_token 的有效期；该接口适用于抖音授权。
access_token 有效期说明
- 当 access_token 过期（过期时间 15 天）后，可以通过该接口使用 refresh_token（过期时间 30 天）进行刷新。刷新后获得一个有效期为15天的 access_token，但是 refresh_token 的有效期保持不变。
- 若 refresh_token 过期，获取 access_token 会报错（error_code=10010），此时需要重新引导用户授权。
- 用户可以在抖音-我-设置（右上角）-账号与安全-授权管理 中取消对应用的授权，取消授权后原有 access_token 会立即失效。
- 抖音开放平台会定期对用户授权进行检查，取消不合规的 access_token 授权。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | |
| HTTP Method | POST |
请求参数
请求头
content-type必填String
示例：application/x-www-form-urlencoded
固定值"application/x-www-form-urlencoded"
Body
client_key必填String
示例：tt10abc****
应用唯一标识
grant_type必填String
示例：refresh_token
固定值“refresh_token”
refresh_token必填String
示例：rft.a736b70544519999a623d67******
填写通过 /oauth/access_token 获取到的 refresh_token 参数
请求示例
curl --location --request POST 'https://open.douyin.com/oauth/refresh_token/' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'client_key=tt10abc****' \ --data-urlencode 'grant_type=refresh_token' \ --data-urlencode 'refresh_token=rft.a736b70544519999a623d67******'
响应参数
Body展开全部子属性
dataStruct
展开子属性
messageString
响应示例
正常响应示例异常响应示例
{ "data": { "access_token": "access_token", "description": "", "error_code": 0, "expires_in": "86400", "open_id": "SuQB*******KN5f", "refresh_expires_in": "86400", "refresh_token": "refresh_token", "scope": "user_info" }, "message": "success" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 10005 | 参数缺失 | 检查参数是否漏传。 |
| 200 | 10002 | 参数错误 | 检查参数是否正确。 |
| 200 | 10010 | refresh_token 已过期 | 检查 refresh_token 参数是否正确，若正确请引导用户重新授权。 |
| 200 | 10001 | 系统错误 | 系统错误，请稍后重试。 |
