接口说明

该接口用于刷新 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	https://open.douyin.com/oauth/refresh_token/
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	系统错误	系统错误，请稍后重试。

刷新 access_token在线调试

接口说明

access_token 有效期说明

基本信息

请求参数

响应参数

错误码

刷新 access_token