抖音开放平台Logo
开发者文档
控制台

核销投稿任务

收藏
我的收藏
Scope: task.posting.user_verification 需要申请权限 不需要用户授权​
该接口用于核销投稿任务。​

使用限制​

    Quota限制:无​
    QPS限制:100/秒​

接口说明​

无​

基本信息​

名称​
描述​
HTTP URL​
HTTP Method​
POST​
Scope​
task.posting.user_verification​
权限要求​
    需要申请权限。路径:​
    移动/网站应用:抖音开放平台控制台 > 应用详情 > 权限管理 > 能力实验室 > 投稿任务权限​

请求头​

名称​
类型​
必填​
描述​
content-type​
string​
是​
固定值 "application/json"​
access-token​
string​
是​
调用 /oauth/client_token/ 生成的 token,此 token 不需要用户授权。示例: clt.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27****

请求示例​

curl --location --request POST 'https://open.douyin.com/task/posting/user/' \ --header 'access-token: clt.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27****' \ --header 'Content-Type: application/json' \ --data-raw '{ "task_id": "@72M0WCqtxuYGiwtkVUYFvH1itu8zRM8IaUCtRwbNa32+7uo2083g2PcEG70*****", "target_open_id": "ba253642-0590-40bc-9bdf-9a1334****", "video_id": "722781567863447****" }'

响应示例​

正常示例​

{ "data": { "result": true, "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2023050516592764C2924BA9979009D249", "now": 1683277168 } }

异常示例​

{ "data": { "error_code": 2100005, "description": "参数不合法" }, "extra": { "description": "参数不合法", "sub_error_code": 0, "sub_description": "", "logid": "202305051653529635CB4F09989324124", "now": 1648731843045, "error_code": 2100005 } }

错误码​

HTTP 状态码​
错误码​
描述​
排查建议​
200​
2100005​
参数不合法​
检查入参​
200​
2100004​
系统繁忙,此时请开发者稍候再试​
平台内部错误,多次重试后仍未恢复,请联系平台OnCall​
200​
2118100​
作品非公开​
检查入参​
200​
2118106​
作品未绑定​
检查入参​
200​
2118110​
请求过于频繁​
请求QPS不要超过100​