创建投稿任务
收藏接口说明
- 一个任务仅允许设置单个核销查询条件，如需查询投稿产生的多个维度数据需创建多个任务
使用限制
- Quota限制：10000/天
- QPS限制：100/秒
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/task/posting/create/ |
| HTTP Method | POST |
| Scope | task.posting.create |
| 权限要求 | 需要申请权限。路径：抖音开放平台控制台 > 应用详情 > 权限管理 > 能力实验室 > 投稿任务权限 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
end_time必填Int64
示例：1234567891
结束时间秒级时间戳
start_time必填Int64
示例：1234567890
开始时间秒级时间戳
task_condition必填Struct
示例：{"condition":"collection","min_value":0,"max_value":100000}
任务条件
展开子属性
task_name必填String
示例：优惠券任务
任务名称，长度不超过50个字符
请求示例
curl --location --request POST 'https://open.douyin.com/task/posting/create/' \ --header 'access-token: clt.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27****' \ --header 'Content-Type: application/json' \ --data-raw '{ "task_name": "测试投稿任务", "task_condition": { "condition": "digg", "min_value": 0, "max_value": 100 }, "start_time": 1682858145, "end_time": 1685000977 }'
响应参数
Body展开全部子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "task_id": "@72M0WCqtxuYGiwtkVUYFvH1itu8zRM8IaUCtRwbNa32+7uo2083g2PcEG70*****", "task_status": 1, "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202305051653529635CB4F099894095439", "now": 1683276833 } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100005 | 参数不合法 | 检查入参 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 平台内部错误，多次重试后仍未恢复，请联系平台OnCall |
| 200 | 2118110 | 请求过于频繁 | 请求QPS不要超过100 |
| 200 | 2118200 | 任务名称长度必须大于0且不超过50 | 检查入参 |
| 200 | 2118201 | 任务名称存在不合法字符 | 检查入参 |
| 200 | 2118202 | 任务条件不存在 | 检查入参 |
| 200 | 2118203 | 任务条件名称不合法 | 检查入参 |
| 200 | 2118204 | 任务条件边界值不合法 | 检查入参 |
| 200 | 2118205 | 任务开始时间不得晚于结束时间 | 检查入参 |
| 200 | 2118206 | 任务结束时间不得晚于当前时间 | 检查入参 |
| 200 | 2118207 | 任务生效时间不得超过31天 | 检查入参 |
