- 小程序 OpenAPI SDK 总览
- OpenAPI 简介
- 用户登录态签名
- 签名算法
- 联合授权
- 接口调用凭证
- 登录
- 小程序码与小程序链接
- Web 化接入
- 私信和群聊
- 解决方案
- 线索组件
- 隐私协议
- 视频能力
- 搜索能力
- 任务能力
- 电商
- 生活服务
- 短剧行业
- 用户信息
- 分享
- 客服
- 交易工具
- 小程序券
- 交易系统
- 素材库
- 内容安全
- 泛知识
- 担保支付
- 评价
- 其它
- 订阅消息
- 小程序推广计划
- 挂载
- 分发
- 数据分析
- 服务类目
- 直播间能力
- 抖音开放能力
- 能力申请
- 页面结构自定义
- 普通二维码绑定
- 抖音号绑定
- 流量主
- 抖店绑定
创建任务
收藏
我的收藏该接口用于创建拍抖音互动任务
使用限制
- •无
接口说明
注意事项
- •创建任务后,需要将task_id通过ShareParam传递给发布器,用户完成拍抖音后会在success回调内返回当前用户的对应任务完成信息。
基本信息
HTTP URL | ||||
HTTP Method | Post | |||
Scope | apps.douyin.interact_task | |||
权限要求 |
|
请求头
名称 | 类型 | 是否必填 | 描述 |
access-token | string | 是 | |
Content-Type | string | 是 | 固定值:application/json |
请求参数
名称 | 类型 | 是否必填 | 描述 | 示例 |
app_id | string | 是 | 小程序id | |
task_type | int32 | 是 | 任务类型 3:拍抖音互动任务 | 3 |
max_count | int64 | 是 | 单用户可重复参与该任务的次数,发布一个视频视作参与一次,参与上限20次。 | 10 |
start_time | int64 | 是 | 开始时间戳,秒级 | 1690875969 |
end_time | int64 | 是 | 结束时间戳,秒级,任务持续时间最长一年 | 1692517569 |
mount_link | string | 是 | 挂载链接 | |
publish_type | list<int> | 是 | 要求发布类型,1:视频,2:图文,为空表明不做要求 | [1] |
tags | list<string> | 是 | 话题标签,用户发布时需要带上的标签内容,可以设置多个,最多支持10个,每个长度上限20 | |
interact_rules | map<string,InteractRule> | 是 | 互动任务目标配置,key代表互动数据类型,key代表目标值。key的取值如下: "like": 点赞数 "share": 分享数 "download": 下载数 "play": 播放数 "comment":评论数 | { "like": { "target_count": 5 }, "share": { "stage_count": 6, "target_count": 20 } } |
- •InteractRule信息
字段 | 类型 | 是否必填 | 说明 | 示例 |
target_count | int | 是 | 目标值,上限为500 | 200 |
stage_count | int | 否 | 单个阶段的数值,下限为5,上限为100 | 20 |
请求示例
PowerShell复制--header 'access-token: clt.*******' \
--header 'Content-Type: application/json' \
--data '{
"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
}
}
}'
响应参数
名称 | | 类型 | 是否必填 | 描述 | 示例 |
err_no | | int64 | 是 | 错误码 | 0 |
err_msg | | string | 是 | 错误信息 | "" |
log_id | | string | 是 | 用于问题快速定位 | 20230803111429010225127084533203 |
data | | object | 是 | 任务信息 | |
| task_id | string | 是 | 任务id | task_7263******7724 |
响应示例
- • 正常示例
JSON复制{
"data": {
"task_id": "task_7263******7724"
},
"err_no": 0,
"err_msg": "",
"log_id": "2023080317282901022512708409145B"
}
- •异常示例
JSON复制{
"err_no": 28001008,
"err_msg": "access_token过期,请刷新或重新授权",
"log_id": "20230803111429010225127084533203"
}
错误码
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的范围内 |
点击纠错