- 移动/网站应用 OpenAPI SDK 总览
- OpenAPI 列表
- 状态码排查工具
- 用户授权
- 用户管理
- 视频管理
- 互动管理
- 搜索管理
- 数据开放服务
- 企业号开放能力(内测结束暂不开放)
- 生活服务开放能力
- 工具能力
- 服务市场开放能力
- 小程序推广计划
- 联合授权
绑定视频
更新时间 2024-07-24 02:58:49
收藏
我的收藏接口说明
- 视频作者必须为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_id | String | 否 | ba253642-0590-40bc-9bdf-9a1334b94059 | 通过/oauth/access_token/获取,用户唯一标志 |
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
task_id | String | 否 | @8hxdhauTCMppanGnM4ltGM780mDqPP+KPpR0qQOmLVAXb/T060zdRmYqig357zEBq6CZRp4NVe6qLIJW/V/x1w== | 创建任务之后获取的任务ID |
video_id | String | 否 | 视频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 | 是 | ||
extra | Struct | 否 |
响应示例
正常响应示例
{
"data": {
"error_code": 0,
"description": ""
},
"extra": {
"error_code": 0,
"description": "",
"sub_error_code": 0,
"sub_description": "",
"logid": "20230505165818C360CD1F4E76E1099B0A",
"now": 1683277099
}
}
异常响应示例
{
"extra": {
"error_code": 2118101,
"description": "作品不是通过此用户发布",
"sub_error_code": 0,
"sub_description": "",
"logid": "20230505165745C360CD1F4E76E10983C5",
"now": 1683277065
},
"data": {
"error_code": 2118101,
"description": "作品不是通过此用户发布"
}
}
错误码
http状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 2100005 | 参数不合法 | 检查入参 |
200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 平台内部错误,多次重试后仍未恢复,请联系平台OnCall |
200 | 2118110 | 请求过于频繁 | 请求QPS不要超过1000 |
200 | 2118100 | 作品非公开 | 当 账号为“私密账号” 或 视频为“私密视频/部分好友可见/密友可见/朋友可见” 或 视频已删除,会返回此错误码 |
200 | 2118101 | 作品不是通过此用户发布 | 检查入参 |
200 | 2118102 | 作品不是通过此应用发布 | 检查入参 |
200 | 2118103 | 作品创建时间早于任务开始时间 | 检查入参 |
200 | 2118104 | 作品类型不是图集或视频 | 检查入参 |
200 | 2118105 | 作品已绑定 |
该文档是否有帮助?
点击纠错