抖音开放平台Logo
控制台

刷新 access_token

收藏
我的收藏
授权整体流程详见授权概述；​

接口说明

该接口用于刷新 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-typeString是application/x-www-form-urlencoded

固定值"application/x-www-form-urlencoded"

请求参数

Body

名称字段类型是否必填示例描述
client_keyString是tt10abc****

应用唯一标识

grant_typeString是refresh_token

固定值“refresh_token”

refresh_tokenString是rft.a736b70544519999a623d67******

填写通过 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

名称字段类型是否必填示例描述
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"
}

异常响应示例

{
  "data": {
    "captcha": "",
    "desc_url": "",
    "description": "refresh_token过期",
    "error_code": 10010
  },
  "message": "error"
}

错误码

http状态码错误码错误码描述排查建议
20010005
参数缺失
检查参数是否漏传。
20010002
参数错误
检查参数是否正确。
20010010
refresh_token 已过期
检查 refresh_token 参数是否正确，若正确请引导用户重新授权。
20010001
系统错误
系统错误，请稍后重试。
​