创建任务
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/v1/douyin/create_interact_task/
权限要求
需要申请能力。开发者需要至控制台-小程序页面下，进入“能力-能力实验室-小程序能力-拍抖音任务”。
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 28005002 | 内部错误 | 内部错误 |
| 200 | 28005001 | 参数解析失败 | 参数解析失败 |
| 200 | 28001003 | accesstoken无效 | accesstoken无效 |
| 200 | 28005078 | 到期时间不在范围内 | 到期时间不在范围内 |
| 200 | 28005073 | 任务类型错误 | 任务类型错误 |
| 200 | 28001018 | 应用未获得该能力 | 前往控制台开通能力 |
| 200 | 28005081 | max count 参数不合法 | max_count 需要控制在1-20的范围内 |
| 200 | 28005083 | mount link 参数不合法 | mount link 需要不为空，长度控制在200以内 |
| 200 | 28005084 | tags 参数不合法 | tags 个数不得超过10个，单tag字节长度不得超过20 |
| 200 | 28005085 | publish type 参数不合法 | 需要传递在规定枚举类型内的 |
| 200 | 28005098 | interact rule 参数为空 | interact_rule 参数为空 |
| 200 | 28005098 | interact rule key 参数不合法 | interact_rule 的key需要在规定枚举类型内 |
| 200 | 28005098 | interact rule target count 参数不合法 | interact_rule 的target_count需要控制在1-500的范围内 |
| 200 | 28005098 | interact rule stage count 参数不合法 | interact_rule 的stage_count需要控制在10-100的范围内 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/v1/douyin/create_interact_task/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"task_type": 3,
"app_id": "ttabc*******",
"start_time": 1690938443,
"end_time": 1702365299,
"max_count": 10,
"mount_link": "path",
"interact_rules": {
"like": {
"stage_count": 6,
"target_count": 1
}
}
}'响应示例响应示例
200 - 成功示例
{
"data": {
"task_id": "task_7263******7724"
},
"err_no": 0,
"err_msg": "",
"log_id": "2023080317282901022512708409145B"
}
修改于 2025-11-10 08:43:31