抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

生成 client-token

收藏
我的收藏
access-token (下文的 client_token)用于不需要用户授权就可以调用的接口。

使用限制

接口说明

该接口用于获取接口调用的凭证 access-token。该接口适用于抖音授权。该凭证在生活服务应用级别有效。

注意事项

    access-token 的有效时间为 2 个小时,重复获取 access-token 后会使上次的 access-token 失效(但有 5 分钟的缓冲时间,连续多次获取 access-token 只会保留最新的两个 access-token)。
    禁止频繁调用 access-token 接口(频控规则:5 分钟内超过 500 次接口调用,接口报错,错误码 10020)。
    正式上线后,测试环境不能使用正式的client_key,client_secret获取token,否则会导致线上正式环境的token失效,影响线上业务。

基本信息

HTTP URL
HTTP Method
POST
权限要求

请求头

名称
类型
必填
描述
Content-Type
string
固定值 "application/json"

请求参数

Body 请求

名称
类型
是否必填
描述
示例值
client_key
string
应用唯一标识,即AppID。
登录开发者控制台后查看应用信息,AppId即client_key
aw05az2qjv******
client_secret
string
应用唯一标识对应的密钥,即Appsecret
登录开发者控制台后查看应用信息,Appsecret即client_secret
7802f4e6f243e659d51135445fe******
grant_type
string
固定值“client_credential”
client_credential

请求示例

curl --location 'https://open.douyin.com/oauth/client_token/' \ --header 'Content-Type: application/json' \ --data '{ "grant_type": "client_credential", "client_key": "aw05az2qjv******", "client_secret": "7802f4e6f243e659d51135445fe********" }'

响应参数

名称
类型
描述
示例值
data
struct
expires_in
int64
access-token 接口调用凭证超时时间,单位(秒)
86400
access_token
string
access-token 接口调用凭证
示例:clt.5a14a88ef6ebcdc4688220d6976510f2aqU4F9S4OudWYC8dCJKLPZ******
description
string
错误码描述
""
error_code
int64
错误码
0
message
string
success

响应示例

正常示例

{ "data": { "access_token": "clt.d69dec57e3643dafe27879d4c397bb4bAoYUs9V1b7RcM71vrxE******", "captcha": "", "desc_url": "", "description": "", "error_code": 0, "expires_in": 7200, "log_id": "20230525192621789E357B281******" }, "message": "success" }

异常示例

{ "data": { "description": "Parameter error", "error_code": 2100005 }, "extra": { "logid": "2020070614111601022506808001045D59", "now": 1594015876138 } }

错误码

HTTP 状态码
错误码
描述
排查建议
200
10002
参数错误
检查参数是否漏传
200
10003
配置无效
检查 client_key 参数是否正确
200
10013
client_key 或者 client_secret 报错
检查 client_key 和 client_secret 是否正确
200
10020
更新频控限制
降低访问频率,合理使用 token 2h 有效期规则