抖音开放平台Logo
开发者文档
控制台

生成 client_token

收藏
我的收藏

接口说明


该接口用于获取接口调用的凭证 client_token。该接口适用于
抖音授权;​


业务场景

client_token 用于不需要用户授权就可以调用的接口。


注意事项

client_token 的有效时间为 2 个小时,重复获取 client_token 后会使上次的 client_token 失效(但有 5 分钟的缓冲时间,连续多次获取 client_token 只会保留最新的两个 client_token)。

基本信息

名称描述
HTTP URL
https://open.douyin.com/oauth/client_token/
HTTP Method
POST

请求参数

请求头
content-type必填String
示例:application/json
固定值"application/json"
Body
client_key必填String
示例:ttxxxxxx

应用唯一标识,即AppID。

client_secret必填String
示例:7802f4e6f243e659d51135445fe******

应用唯一标识对应的密钥,可以在开发者后台获取,即secret。

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": "ttxxxxxx", "client_secret": "7802f4e6f243e659d51135445fe********" }'

响应参数

Body展开全部子属性
dataStruct
展开子属性
messageString
示例:success

请求响应

响应示例
正常响应示例异常响应示例
{ "data": { "access_token": "clt.75c380db41e815978a733994d96f5d23RqilUxH48iobyWhbIOQFo******", "description": "", "error_code": 0, "expires_in": 7200 }, "message": "success" }

错误码

HTTP 状态码错误码错误码描述排查建议
20010002
参数错误
检查参数是否漏传
20010003
client_key 不存在
检查 client_key 参数是否正确
20010013
client_key 或者 client_secret 报错
检查 client_key 和 client_secret 是否正确