获取短视频/直播自主挂载抖音号绑定二维码

收藏
我的收藏

本接口已于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

请求示例

https://developer.toutiao.com/api/apps/v1/capacity/get_self_mount_bind_qrcode?capacity_key=video_self_mount

响应信息

响应体

属性
数据类型
说明
err_no
number
错误码,0 是成功,其它为异常
err_msg
string
成功为"success", 错误为具体 message
data
object
qrcode_url
string
二维码图片url,可直接访问展示二维码图片。有效期为 24 小时。
qrcode_parse_content
string
二维码url字符串,需开发者自行构造二维码图片。

响应示例

{ "err_no": 0, "err_msg": "success", "data": { "qrcode_url": "https://xxxx", "qrcode_parse_content": "https://xxxx" } }

错误码

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