绑定视频
收藏接口说明
- 视频作者必须为OpenID对应的用户
- 视频必须为公开状态当 账号为“私密账号” 或 视频为“私密视频/部分好友可见/密友可见/朋友可见” 或 视频已删除，视频会被认为非公开
- 视频必须为通过ClientToken对应的应用发布
- 视频发布时间不得早于任务开始时间
- 视频必须为视频/图集类型
使用限制
- Quota限制：无
- QPS限制：1000/秒
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/task/posting/bind_video/ |
| HTTP Method | POST |
| Scope | posting.behavior |
| 权限要求 | 投稿任务绑定视频ID posting.behavior(user_scope) 投稿任务绑定视频ID |
请求参数
请求头
access-token必填String
示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Query
open_idString
示例：ba253642-0590-40bc-9bdf-9a1334b94059
通过/oauth/access_token/获取，用户唯一标志
Body
task_idString
示例：@8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w==
创建任务之后获取的任务ID
video_idString
示例：视频ID
视频ID
请求示例
curl --location --request POST 'https://open.douyin.com/task/posting/bind_video/?open_id=ba253642-0590-40bc-9bdf-9a1334****' \ --header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiu****' \ --header 'Content-Type: application/json' \ --data-raw '{ "video_id": "722781567863447****", "task_id": "@72M0WCqtxuYGiwtkVUYFvH1itu8zRM8IaUCtRwbNa32+7uo2083g2PcEG70*****" }'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20230505165818C360CD1F4E76E1099B0A", "now": 1683277099 } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100005 | 参数不合法 | 检查入参 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 平台内部错误，多次重试后仍未恢复，请联系平台OnCall |
| 200 | 2118110 | 请求过于频繁 | 请求QPS不要超过1000 |
| 200 | 2118100 | 作品非公开 | 当 账号为“私密账号” 或 视频为“私密视频/部分好友可见/密友可见/朋友可见” 或 视频已删除，会返回此错误码 |
| 200 | 2118101 | 作品不是通过此用户发布 | 检查入参 |
| 200 | 2118102 | 作品不是通过此应用发布 | 检查入参 |
| 200 | 2118103 | 作品创建时间早于任务开始时间 | 检查入参 |
| 200 | 2118104 | 作品类型不是图集或视频 | 检查入参 |
| 200 | 2118105 | 作品已绑定 |
