输入抖音号绑定
接口说明
该接口提供于服务商代调用场景,用于输入抖音号绑定BC关系
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/apps/v1/capacity/bind_aweme_relation/ |
HTTP Method | POST |
Scope | ma.relation.bind |
权限要求 |
|
请求参数
请求头
access-token必填String
示例:isvact.0801121846735352506a356a6
content-type必填String
示例:application/json
固定值"application/json"
Body展开全部子属性
aweme_id必填String
抖音号
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:员工号绑定
audit_template_infoMap
资质信息map,每个能力只需要上传一个资质信息
map 的 key 为能力 capacity_key
value 为资质信息
展开子属性
co_subjectBool
示例:false
抖音号和小程序是否是相同的主体,品牌号绑定时必传
cooperation_infoStruct
合作号信息,合作号绑定时必传
展开子属性
employee_infoStruct
员工号信息,员工号绑定时必传
展开子属性
请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/capacity/bind_aweme_relation/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"employee_info":{"relation_expire_date":6182115480795152177,"qualification_type":"person","qualification_image_list":["dpNbt49OYK"],"real_name":"小平","identity_number":"L0UIPirJC6","contract_image":"5JnTdW3CbR"},"audit_template_info":{"QL7rwwSNXh":{"id":1039495565162895323,"title":"kgPbI4sbLW","desc":"bgnoQlmr9h","template_content":[{"ValDesc":["FNci2x7Flx"],"name":"tuTda7yMta","desc":"0XB6YX81B4","val_type":1,"val_example":["6Un9pFR4nz"],"val_list":["jgrKT12ETJ"],"reject_reason":"7ArRi39Wwk","materiel_id":"1bybqEM0z8"}]}},"type":"brand","aweme_id":"6ZycG4oL6Y","capacity_list":["video_self_mount"],"co_subject":false,"cooperation_info":{"company_name":"XX","business_license_code":"123456789","real_name":"小平公司","identity_number":"olDBxsnBCj","contract_image":"NdZ7QFpcxH","contract_image_list":["5xSm9WVDVK"],"relation_expire_date":4404854813175490268,"cooperation_type":"enterprise"}}'
响应参数
Body
err_msg必填String
err_no必填Int32
log_id必填String
响应示例
正常响应示例异常响应示例
{ "log_id": "", "err_no": 0, "err_msg": "" }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 60001 | 参数错误 | |
200 | 60000 | 系统错误 | |
200 | 60007 | 非法scope | |
200 | 60003 | 必填参数缺失 | 请确认提审信息是否完善 |
200 | 62001 | 代运营服务商和小程序没有授权关系 | |
200 | 62004 | 用户ID没有管理权限 | |
200 | 10000 | 不支持的操作 | |
200 | 60145 | 挂载能力有误,不允许授权 | 请检查对应能力是否已开通 |
200 | 60008 | 不同主体抖音号 | 请检查输入抖音号企业认证主体和小程序主体是否一致 |
200 | 60009 | 非法的抖音号 | |
200 | 61000 | 单个小程序绑定品牌号数量超限 | |
200 | 61001 | 单个小程序绑定员工号数量超限 | |
200 | 61002 | 单个小程序绑定合作号数量超限 | |
200 | 61003 | 单个抖音号绑定品牌号数量超限 | |
200 | 61004 | 单个抖音号绑定员工号数量超限 | |
200 | 61005 | 单个抖音号绑定合作号数量超限 | |
200 | 60154 |
| 对于不同行业及关系类型,会有不同的限制,更多的绑定限制,可参考 小程序经营矩阵帐号FAQ |