刷新 refresh_token__抖音开放平台

接口说明

该接口用于刷新 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	正式地址：https://open.douyin.com/oauth/renew_refresh_token/ 沙盒地址：https://open-sandbox.douyin.com/oauth/renew_refresh_token/
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	超过刷新次数限制	无法再刷新，请让用户重新授权。

刷新 refresh_token在线调试

接口说明

基本信息

请求头

请求参数

Body

请求示例

响应参数

Body

响应示例

正常响应示例

异常响应示例

错误码

刷新 refresh_token