生成 access-token

更新时间 2024-08-16 03:03:44

我的收藏

access-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。	aw05az2qjv******
client_secret	string	是	应用唯一标识对应的密钥，即Appsecret	7802f4e6f243e659d51135445fe******
grant_type	string	是	固定值“client_credential”	client_credential

请求示例

js复制
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

响应示例

正常示例

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

异常示例

json复制
{
  "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 有效期规则