抖音开放平台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-typeString是application/json
固定值"application/json"

请求参数

Body

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

应用唯一标识，即AppID。

client_secretString是7802f4e6f243e659d51135445fe******

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

grant_typeString是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

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

请求响应

响应示例

正常响应示例

{
  "data": {
    "access_token": "clt.75c380db41e815978a733994d96f5d23RqilUxH48iobyWhbIOQFo******",
    "description": "",
    "error_code": 0,
    "expires_in": 7200
  },
  "message": "success"
}

异常响应示例

{
  "data": {
    "captcha": "",
    "desc_url": "",
    "description": "配置无效",
    "error_code": 10003
  },
  "message": "error"
}

错误码

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