创建任务
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/v1/douyin/create_task/
权限要求
需要申请能力。开发者需要至控制台-小程序页面下，进入“能力-能力实验室-小程序能力-拍抖音任务”。
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005002 | 内部错误 | 内部错误 |
| 200 | 28005001 | 参数解析失败 | 参数解析失败 |
| 200 | 28001003 | accesstoken错误 | accesstoken错误 |
| 200 | 28005022 | 到期时间不在范围内 | 到期时间不在范围内 |
| 200 | 28005073 | 任务类型错误 | 任务类型错误 |
| 200 | 28001018 | 应用未获得该能力 | 前往控制台开通能力 |
| 200 | 28005081 | target count 参数不合法 | targetcount需要控制在1-99的范围内 |
| 200 | 28005083 | mount link 参数不合法 | mount link 需要不为空，长度控制在200以内 |
| 200 | 28005084 | tags 参数不合法 | tags 个数不得 超过10个，单tag字节长度不得超过20 |
| 200 | 28005085 | publish type 参数不合法 | 需要传递在规定枚举类型内的 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.douyin.com/api/apps/v1/douyin/create_task/' \
--header 'access-token: clt.******' \
--header 'Content-Type: application/json' \
--header 'Cookie: passport_csrf_token=450ada6c84f30a5374fecac5a799f62c; passport_csrf_token_default=450ada6c84f30a5374fecac5a799f62c' \
--data-raw '{
"app_id": "tt**********",
"task_type": 2,
"rule_type": 1,
"target_count": 1,
"start_time": 1694423074,
"end_time": 1694623074,
"mount_link": "/pages/index",
"publish_type": [
1
],
"tags": [
"**"
]
}'响应示例响应示例
200 - 成功示例
{
"data": {
"task_id": "task_7263******7724"
},
"err_no": 0,
"err_msg": "",
"log_id": "2023080317282901022512708409145B"
}
修改于 2025-11-10 08:42:35