- 生活服务商家应用 OpenAPI SDK 总览
- OpenAPI
- 门店管理
- 团购核销
- 团购对账
- 会员接入
- 订单查询
- 三方码
- 商品发布及查询
- 酒旅
- 预置码
- 代运营
- 接入前准备
- 餐饮团购
- 线索经营
- 团购退款
生成 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 | |
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 有效期规则 |
点击纠错