查询短视频/直播自主挂载能力绑定抖音号列表

收藏
我的收藏

本接口已于2024年1月3日随普通抖音号能力正式下线,不再继续提供调用服务

接口说明

拥有短视频/直播自主挂载能力后,查询小程序短视频/直播自主挂载能力绑定的抖音号列表。

请求信息

名称
HTTP URL
HTTP Method
GET
Scope
权限要求
服务商代调用场景下,需商家授予运营管理权限集

请求头

名称
类型
必填
描述
access-token
string
token获取接口(其中服务商代调用场景的token获取接口

请求查询参数

名称
类型
是否必填
描述
示例值
capacity_key
string
能力key。video_self_mount-短视频自主挂载;live_self_mount-直播自主挂载
video_self_mount
page_num
number
分页编号;从1开始。
1
page_size
number
分页大小;小于等于 50。
20

请求示例

https://developer.toutiao.com/api/apps/v1/capacity/query_self_mount_user_list?capacity_key=video_self_mount&page_num=1&page_size=20

响应信息

响应体

属性
数据类型
说明
err_no
number
错误码,0 是成功,其它为异常。
err_msg
string
成功为"success", 错误为具体 message。
data
object
total_count
number
绑定抖音号列表记录总数。
list
array
绑定抖音号列表。
aweme_id
string
抖音号。
user_name
string
抖音号昵称。
account_type
number
抖音号类型。1-个人号;2-企业号。
bind_status
number
绑定状态。1-绑定中;2-绑定成功;3-绑定失败;4-取消绑定;5-封禁绑定;6-绑定失效。
unbind_reason
string
解绑原因。

响应示例

{ "err_no": 0, "err_msg": "success", "data": { "total_count": 10, "list": [ { "aweme_id": "2012xxxx", "user_name": "xxx", "account_type": 1, "bind_status": 1, "unbind_reason": "" } ] } }

错误码

错误码
描述
排查建议
-1
系统错误
建议重试
11001
appid无法解析
建议重试
11009
参数不合法或缺少参数
检查参数合法性
11016
access_token不正确或者已过期
检查access_token合法性
40006
非法请求,请求 IP 不在第三方小程序应用 IP 地址白名单内
添加IP地址到白名单内或者配置白名单为空
40036
授权小程序未授予该接口对应的权限
引导商家授予相关权限集
28005036
绑定账号数量超过上限
解除绑定释放绑定数量
28005037
抖音号不存在
检查抖音号合法性
28005035
未获取对应自主挂载能力
申请对应自主挂载能力
28005038
该抖音号已经绑定
换其他抖音号重试
28005039
该抖音号绑定中
换其他抖音号重试
28005040
账号解除绑定次数超过上限
次月再解除