自主挂载存量视频绑定锚点
收藏接口说明
小程序开通能力并得到用户授权后，可以为该用户30天内发布的且历史上未挂载过锚点的公开视频挂载锚点
使用限制
- 调用方是小程序的开发者/代开发
- 视频作者ID有授权给小程序“存量视频自动挂锚点”能力
- 如何获取能力：小程序上线即可自动获取
- 此能力需使用client_token
- 视频历史上未绑定过锚点
- 视频发布时间在30天内
- 视频存在且为【公开视频】状态
- 小程序有短视频自主挂载能力
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/aweme/v1/video/self/mount/ |
| HTTP Method | POST |
| Scope | ma.self_mount_video.mount |
| 权限要求 | 自挂载存量视频挂锚点 给自挂载存量视频挂锚点 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Body
app_title必填String
示例：标题名称
锚点标题
app_url必填String
示例：page/index
锚点url
item_id必填String
视频 ID
micro_app_id必填String
示例：tt11111111a111
小程序ID
请求示例
curl -X POST 'https://open.douyin.com/aweme/v1/video/self/mount/' -H 'Content-Type:application/json' -H 'access-token:clt.dd0f561xxxxxHiuuGcIbZWCLol4nisVbxn' --data '{ "item_id":"7268186515xxx375", "app_title":"标题名称", "micro_app_id":"tte78f9xxx8b3401", "app_url":"https://p3-developer-sign.bytemaimg.com/ttgame-open-share/CwdhSIJ3gspTONBoabQ8p1DaA3~tplv-xxxxxx-jpg.jpeg?x-expires=1696822449\\u0026x-signature=eg%2Fxxxxxxx" }'
响应参数
Body
err_msg必填String
err_no必填Int32
log_id必填String
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 29003015 | 无权限操作该作者的视频 | 用户未授权“在已发布的短视频中挂载小程序”能力 |
| 200 | 29003016 | 该视频不存在或为非公开视频，不可添加 | |
| 200 | 29003017 | 视频发布时间已超过30天，不可添加 | |
| 200 | 29003018 | 视频当前或历史已绑定过小程序锚点，不可重复添加 | |
| 200 | 29003019 | 视频锚点已被解绑，不可重复解绑 | |
| 200 | 29003020 | 非本人绑定的锚点，不可解绑 | 必须是同一开发者绑定的锚点才可以解绑 |
| 200 | 29003021 | 锚点绑定失败 | 此错误非权限问题，推荐重试 |
| 200 | 29003022 | 无权限操作该小程序的锚点 | 小程序没有自挂载权限 |
| 200 | 29003023 | 用户与小程序无自挂载关系 | |
| 200 | 29003024 | 请求参数不合法 | 入参均必传，且获取clientKey的appID应该和传入的appID保持一致 |
| 200 | 29003025 | 锚点解绑失败 | |
| 200 | 29003032 | 视频已有非小程序类型锚点，不支持增加小程序锚点 | |
| 200 | 29003035 | 该用户有处罚记录，禁止挂载 | |
| 200 | 29003036 | 该小程序禁止通过该方式挂载 |
