抖音开放平台Logo
开发者文档
直播互动工具
控制台
  • getAccessToken
  • 获取应用授权调用凭证
  • 内容安全检测
  • 图片检测 V2

    • 获取应用授权调用凭证
    收藏
    我的收藏

    接口说明

    该接口用于获取接口调用的凭证 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

    名称
    字段类型
    是否必填
    示例
    描述
    data
    Struct
    否
    ​
    ​
    access_token
    String
    否
    clt.5a14a88ef6ebcdc4688224YC8dCJKLPZ******
    client_token 接口调用凭证
    ​
    description
    String
    否
    ​
    ​
    error_code
    Int64
    否
    ​
    ​
    expires_in
    Int64
    否
    86400
    client_token 接口调用凭证超时时间，单位（秒）
    message
    String
    否
    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 状态码
    错误码
    错误码描述
    排查建议
    200
    10002
    参数错误
    检查参数是否漏传
    200
    10003
    client_key 不存在
    检查 client_key 参数是否正确
    200
    10013
    client_key 或者 client_secret 报错
    ​
    检查 client_key 和 client_secret 是否正确
    ​
    ​
    ​
    ​
    ​
    ​
    ​
    ​
    ​