• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 联合授权
  • 视频能力
  • 线索组件
  • 接口调用凭证
  • 经营能力调用凭证
  • 非用户授权调用凭证
  • 获取应用授权调用凭证
  • getAccessToken
  • 用户授权调用凭证
  • 登录
  • Web 化接入
  • 隐私协议
  • 流量主
  • 小程序码与小程序链接
  • 用户信息
  • 抖音号绑定
  • 小程序推广计划
  • 内容安全
  • 任务能力
  • 分享
  • 客服
  • 小程序券
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 接口说明


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