创建任务
收藏接口说明
该接口用于创建拍抖音任务。
创建任务后，需要将task_id通过ShareParam传递给发布器，用户完成拍抖音后会在success回调内返回当前用户的对应任务完成信息。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v1/douyin/create_task/ |
| HTTP Method | POST |
| Scope | apps.douyin.task |
| 权限要求 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Body
app_id必填String
示例：tt********
小程序id
end_time必填Int64
示例：1692517569
结束时间戳，秒级，任务持续时间最长一年
mount_link必填String
挂载链接
publish_type必填Array<Int32>
要求发布类型，1：视频，2：图文，为空表明不做要求
rule_type必填Int32
示例：2
规则类型，
1：流量类型：用户发布内容，满足类型标签条件即视为成功，不关注是否处于公开可见状态；
2：长期任务类型：用户发布内容，需要保证是过审公开状态，并满足类型和标签条件，任务变动会产生webhook推送通知
start_time必填Int64
示例：1690875969
开始时间戳，秒级
tags必填Array<String>
话题标签，用户发布时需要带上的标签内容，可以设置多个，最多支持10个，每个长度上限20
target_count必填Int64
示例：3
目标拍抖音发布次数，用户需要发布拍抖音内容达到本参数设置次数，才视为整个任务完成
task_type必填Int32
示例：2
任务类型
2：拍抖音任务
请求示例
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": [ "**" ] }'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String
错误信息
err_no必填Int32
错误码
log_id必填String
用于快速定位问题，可在社区反馈时提供
响应示例
正常响应示例异常响应示例
{ "data": { "task_id": "task_7263******7724" }, "err_no": 0, "err_msg": "", "log_id": "202308031728290102251270840914XX" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005002 | 内部错误 | 内部错误 |
| 200 | 28005001 | 参数解析失败 | 参数解析失败 |
| 200 | 28001003 | access_token错误 | 重新获取access_token，见client_token获取说明 |
| 200 | 28005022 | 到期时间不在范围内 | 到期时间不在范围内 |
| 200 | 28005073 | 任务类型错误 | 任务类型错误 |
| 200 | 28001018 | 应用未获得该能力 | 前往控制台开通能力 |
| 200 | 28005081 | target count 参数不合法 | target count需要控制在1-99的范围内 |
| 200 | 28005083 | mount link 参数不合法 | mount link 需要不为空，长度控制在200以内 |
| 200 | 28005084 | tags 参数不合法 | tags 个数不得超过10个，单tag字节长度不得超过20 |
| 200 | 28005085 | publish type 参数不合法 | 需要传递在规定枚举类型内的 |
