抖音开放平台Logo
控制台

刷新 refresh_token

更新时间 2024-07-24 02:58:49
收藏
我的收藏
授权整体流程详见授权概述。​
client_key 必须拥有 renew_refresh_token 权限。​

接口说明

该接口用于刷新 refresh_token 的有效期。该接口适用于抖音授权。​


注意事项

  • 刷新操作需要在 refresh_token 过期前进行。​
  • 通过旧的 refresh_token 获取新的 refresh_token,调用后旧 refresh_token 会失效,新 refresh_token 有 30 天有效期。最多只能获取 5 次新的 refresh_token,5 次过后需要用户重新授权

基本信息

请求头

名称字段类型是否必填示例描述
Content-TypeStringapplication/x-www-form-urlencoded

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

请求参数

Body

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

应用唯一标识

refresh_tokenStringrft.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

名称字段类型是否必填示例描述
messageString

响应示例

正常响应示例

{
  "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状态码错误码错误码描述排查建议
20010005
缺少参数
检查是否填写 client_key 和 refresh_token 参数,请求格式是否正确。
20010004
权限不足
请申请 renew_refresh_token 权限。
20010010
refresh_token 过期
token 已过期,请让用户重新授权。
20010020
超过刷新次数限制
无法再刷新,请让用户重新授权。