核销投稿任务

更新时间 2024-07-24 02:58:49

我的收藏

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****`

请求示例

text复制
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****"
}'

响应示例

正常示例

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

异常示例

json复制
{
  "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