自主挂载存量视频解绑锚点
收藏接口说明
小程序开通能力并得到用户授权后，可以为该用户通过OpenAPI挂载的锚点进行解绑
使用限制
- 调用方是小程序的开发者/代开发
- 视频作者ID有授权给小程序“存量视频自动挂锚点”能力
- 如何获取能力：小程序上线即可自动获取
- 此能力需使用client_token
- 视频当前存在锚点且为开发者通过OpenAPI挂载
- 视频存在且为【公开视频】状态
- 小程序有短视频自主挂载能力
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/aweme/v1/video/self/mount_cancel/ |
| HTTP Method | POST |
| Scope | ma.self_mount_video.mount |
| 权限要求 | 自挂载存量视频解绑锚点 给自挂载存量视频挂锚点 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body
item_id必填String
视频 ID
micro_app_id必填String
示例：tt11111111a111
小程序ID
请求示例
curl -X POST 'https://open.douyin.com/aweme/v1/video/self/mount_cancel/' -H 'Content-Type:application/json' -H 'access-token:clt.dd0f561xxx063182f72ae5e52L6QCUZHiuuGcIbZWCLol4nisVbxn' --data '{ "item_id":"7268186xxx5375", "micro_app_id":"tte78fxxx08b3401" }'
响应参数
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 | 锚点解绑失败 |
