抖音开放平台Logo
开发者文档
控制台
  • OpenAPI 列表
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 用户授权
  • 抖音获取授权码
  • 获取 access_token
  • 刷新 refresh_token
  • 生成 client_token
  • 刷新 access_token
  • 用户管理
  • 视频管理
  • 互动管理
  • 搜索管理
  • 数据开放服务
  • 企业号开放能力(内测结束暂不开放)
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • 生成 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 是否正确