BusinessToken 生成
收藏接口说明
经营 Token 是面向经营关系场景内 OpenAPI 调用的鉴权工具。可以由开发者自行签发，在进行经营能力调用时，用作凭证。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/oauth/business_token/ |
| HTTP Method | POST |
| Scope | ma.business_token |
请求参数
请求头
content-type必填String
示例：application/json
固定值"application/json"
Body
client_key必填String
示例：tt*********01
抖音开发平台接入方标识，小程序调用时填入 AppID
client_secret必填String
示例：d0218aaf39*********672
接入方密钥，可以从
开发-开发配置-Webhook 页面的 Webhook AppSecret 位置获取。
注意：不是开发-开发配置-密钥管理的AppSecret
open_id必填String
示例：49023c2e-*********5-056281025e89
用于指定Token所对应的用户。
scope必填String
示例：ma.user.data_bc,ma.item.data_bc
用于指定Token所对应 的能力，逗号分割。可以根据业务场景自行隔离，控制 Token 泄露风险。
请求示例
curl --location 'https://open.douyin.com/oauth/business_token/' \ --header 'Content-Type: application/json' \ --data '{ "client_key": "tt88*********a38f01", "client_secret": "d0218aaf399*********9ef92bc84672", "open_id": "49023c2e-*********-056281025e89", "scope": "video.data.bind" }'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
error_code必填Int64
message必填String
响应示例
正常响应示例异常响应示例
{ "biz_token": "bus_act.3c2f5cc363d5c464e509c066*********oDYf3Fmzl6ztOYr", "biz_expires_in": 2592000, "biz_refresh_token": "bus_rft.537b533773845107214b*********lwiBOqil5xceQ4MMI", "biz_refresh_expires_in": 3153600, }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001007 | 参数不合法 | 重新检查入参，确认 OpenID 与应用对应 |
| 200 | 29002002 | ClientKey不合法 | 检查 Client Key 字段入参，确认应用当前状态正常
|
| 200 | 28001004 | open_id invalid | 检查 open_id 字段入参 |
