查询短视频/直播自主挂载能力绑定抖音号列表
收藏
我的收藏本接口已于2024年1月3日随普通抖音号能力正式下线,不再继续提供调用服务
接口说明
拥有短视频/直播自主挂载能力后,查询小程序短视频/直播自主挂载能力绑定的抖音号列表。
请求信息
名称 | 值 | |||
HTTP URL | ||||
HTTP Method | GET | |||
Scope | 无 | |||
权限要求 | 服务商代调用场景下,需商家授予运营管理权限集 |
请求头
请求查询参数
名称 | 类型 | 是否必填 | 描述 | 示例值 |
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 | 账号解除绑定次数超过上限 | 次月再解除 |