创建任务
接口说明
该接口用于创建拍抖音任务。
创建任务后,需要将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"
Body
app_idString
小程序id
end_timeInt64
结束时间戳,秒级,任务持续时间最长一年
mount_linkString
挂载链接
publish_typeList
要求发布类型,1:视频,2:图文,为空表明不做要求
rule_typeInt32
规则类型,
1:流量类型:用户发布内容,满足类型标签条件即视为成功,不关注是否处于公开可见状态;
2:长期任务类型:用户发布内容,需要保证是过审公开状态,并满足类型和标签条件,任务变动会产生webhook推送通知
start_timeInt64
开始时间戳,秒级
tagsList
话题标签,用户发布时需要带上的标签内容,可以设置多个,最多支持10个,每个长度上限20
target_countInt64
目标拍抖音发布次数,用户需要发布拍抖音内容达到本参数设置次数,才视为整个任务完成
task_typeInt32
任务类型
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展开全部子属性
dataStruct
展开子属性
err_msgString
错误信息
err_noInt32
错误码
log_idString
用于快速定位问题,可在社区反馈时提供
响应示例
正常响应示例异常响应示例
{ "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 参数不合法 | 需要传递在规定枚举类型内的 |
