抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • SPI签名机制说明
  • 生成 client-token
  • 生活服务消息推送
  • 加密字段解密方法
  • 通用参数
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档（不推荐）

    • 生成 client-token

    收藏
    我的收藏
    access-token （下文的 client_token）用于不需要用户授权就可以调用的接口。

    使用限制

    无

    接口说明

    该接口用于获取接口调用的凭证 access-token。该接口适用于抖音授权。该凭证在生活服务应用级别有效。

    注意事项

      •access-token 的有效时间为 2 个小时，重复获取 access-token 后会使上次的 access-token 失效（但有 5 分钟的缓冲时间，连续多次获取 access-token 只会保留最新的两个 access-token）。
      •禁止频繁调用 access-token 接口（频控规则：5 分钟内超过 500 次接口调用，接口报错，错误码 10020）。
      •正式上线后，测试环境不能使用正式的client_key,client_secret获取token，否则会导致线上正式环境的token失效，影响线上业务。
    ​

    基本信息

    HTTP URL
    正式环境：https://open.douyin.com/oauth/client_token/
    HTTP Method
    POST
    权限要求
    无

    请求头

    名称
    类型
    必填
    描述
    Content-Type
    string
    是
    固定值 "application/json"

    请求参数

    Body 请求

    名称
    类型
    是否必填
    描述
    示例值
    client_key
    string
    是
    应用唯一标识，即AppID。
    登录开发者控制台后查看应用信息，AppId即client_key
    ​
    ​
    aw05az2qjv******
    ​
    client_secret
    string
    是
    应用唯一标识对应的密钥，即Appsecret
    登录开发者控制台后查看应用信息，Appsecret即client_secret
    ​
    7802f4e6f243e659d51135445fe******
    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": "aw05az2qjv******",
    "client_secret": "7802f4e6f243e659d51135445fe********"
}'

    响应参数

    名称
    类型
    描述
    示例值
    data
    struct
    ​
    ​
    expires_in
    int64
    access-token 接口调用凭证超时时间，单位（秒）
    86400
    access_token
    string
    access-token 接口调用凭证
    示例：clt.5a14a88ef6ebcdc4688220d6976510f2aqU4F9S4OudWYC8dCJKLPZ******
    description
    string
    错误码描述
    ""
    error_code
    int64
    错误码
    0
    message
    string
    ​
    success

    响应示例

    正常示例

    {
  "data": {
    "access_token": "clt.d69dec57e3643dafe27879d4c397bb4bAoYUs9V1b7RcM71vrxE******",
    "captcha": "",
    "desc_url": "",
    "description": "",
    "error_code": 0,
    "expires_in": 7200,
    "log_id": "20230525192621789E357B281******"
  },
  "message": "success"
}

    异常示例

    {
  "data": {
    "description": "Parameter error",
    "error_code": 2100005
  },
  "extra": {
    "logid": "2020070614111601022506808001045D59",
    "now": 1594015876138
  }
}

    错误码

    HTTP 状态码
    错误码
    描述
    排查建议
    200
    10002
    参数错误
    检查参数是否漏传
    200
    10003
    配置无效
    检查 client_key 参数是否正确
    200
    10013
    client_key 或者 client_secret 报错
    检查 client_key 和 client_secret 是否正确
    200
    10020
    更新频控限制
    降低访问频率，合理使用 token 2h 有效期规则