刷新用户授权调用凭证

该接口用于刷新 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 状态码	错误码	描述	排查建议
200	10005	参数缺失	检查参数是否漏传。
200	10002	参数错误	检查参数是否正确。
200	10010	refresh_token 已过期	检查 refresh_token 参数是否正确，若正确请引导用户重新授权。
200	10001	系统错误	系统错误，请稍后重试。

curl --location --request POST 'http://dev-cn.your-api-server.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******'

{ "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" }

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

Body 参数application/x-www-form-urlencoded

client_key

string

应用唯一标识

必需

示例值:

tt10abc****

grant_type

string

必需

固定值“refresh_token”

示例值:

refresh_token

string

必需

填写通过 access_token 获取到的 refresh_token 参数

示例值:

rft.a736b70544519999a623d67******

返回响应

🟢200成功

application/json

Body

data

object

必需

access_token信息

access_token

string

接口调用凭证

必需

description

string

错误码描述

必需

error_code

integer

错误码

必需

expires_in

string

必需

过期时间，单位（秒）

open_id

string

必需

当前应用下，授权用户唯一标识

refresh_expires_in

string

必需

refresh_token凭证超时时间，单位（秒)

refresh_token

string

用户刷新

必需

scope

string

用户授权的作用域

必需

message

string

请求响应

必需

🟠400请求有误

刷新用户授权调用凭证

接口说明#

错误码#

请求参数

返回响应

接口说明

错误码