核销投稿任务

我的收藏

Scope: task.posting.user_verification 需要申请权限不需要用户授权

该接口用于核销投稿任务。

使用限制

◦

Quota限制：无

◦

QPS限制：100/秒

接口说明

无

基本信息

名称	描述
HTTP URL	https://open.douyin.com/task/posting/user/
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

核销投稿任务在线调试

使用限制

接口说明

基本信息

请求头

请求示例

响应示例

正常示例

异常示例

错误码

核销投稿任务