获取抖音号绑定所需的资质模版列表
接口说明
该接口用于查询进行抖音号绑定时所需要的资质模版列表。
- 在进行抖音号绑定前必须先调用该接口查询绑定的能力是否需要上传资质。
- 当一个能力存在多个资质模版,只需要选择其中一个资质模版进行上传。
使用限制
该接口提供于服务商代调用场景,获取token获取接口
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/apps/v1/capacity/get_aweme_bind_template_list/ |
HTTP Method | POST |
Scope | ma.relation.bind |
权限要求 |
|
请求参数
请求头
access-token必填String
示例:isvact.0801121846735352506a356a6
content-type必填String
示例:application/json
固定值"application/json"
Body
aweme_id必填String
示例:XXXXXXX
抖音号
capacity_list必填Array<String>
示例:video_self_mount
绑定能力列表
- video_self_mount:短视频自主挂载
- live_self_mount:直播自主挂载
- ma.im.life_im: 本地生活im
- ma.component.instant_messaging:私信组件
- ma.jsapi.authorizePrivateMessage:主动授权私信组件
type必填String
示例:brand
绑定类型
- brand:品牌号绑定
- cooperation:合作号绑定
- employee:员工号绑定
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/capacity/get_aweme_bind_template_list/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"type":"brand","capacity_list":["video_self_mount"],"aweme_id":"4TOiSvx89p"}'
响应参数
Body展开全部子属性
err_msg必填String
err_no必填Int32
log_id必填String
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_no": 1366797220853092600, "err_msg": "pkWDkzNGHb", "log_id": "cezjxtoPu0", "data": { "template_map": { "xXfB8KA6J4": [ { "title": "GcvrIuXWI9", "Status": 8223642108882995000, "reason": "9jI13sSvkZ", "StatusDesc": "a6EZ0vse17", "category_name": "sksNoxU9To", "category_id": "qNJc1eLCEW", "can_apply": false, "template_id": 4837835435925716000, "Base": { "Client": "wxSDSxOS5v", "TrafficEnv": { "Open": false, "Env": "4URysuLCAC" }, "Extra": { "zeOl3clBvU": "a6V2zynCct" }, "LogID": "ehKgW5Amzv", "Caller": "tdBVAaYAFf", "Addr": "bx9MudyLY9" } } ] } } }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 28001008 | access_token过期,请刷新或重新授权 | |
200 | 28001007 | 参数不合法 |