- 移动/网站应用 OpenAPI SDK 总览
- OpenAPI 列表
- 状态码排查工具
- 用户授权
- 用户管理
- 视频管理
- 互动管理
- 搜索管理
- 数据开放服务
- 企业号开放能力(内测结束暂不开放)
- 生活服务开放能力
- 工具能力
- 服务市场开放能力
- 小程序推广计划
- 联合授权
创建投稿任务
更新时间 2024-07-24 02:58:49
收藏
我的收藏接口说明
- 一个任务仅允许设置单个核销查询条件,如需查询投稿产生的多个维度数据需创建多个任务
使用限制
- 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
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
data | Struct | 否 | ||
extra | Struct | 否 |
响应示例
正常响应示例
{
"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
}
}
异常响应示例
{
"data": {
"error_code": 2118200,
"description": "任务名称长度必须大于0且不超过50"
},
"extra": {
"description": "任务名称长度必须大于0且不超过50",
"sub_error_code": 0,
"sub_description": "",
"logid": "202305051653529635CB4F09989324124",
"now": 1648731843045,
"error_code": 2118200
}
}
错误码
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天 | 检查入参 |
该文档是否有帮助?
点击纠错