创建直播间任务
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/taskbox/add_room_task/
使用限制
接口说明
形态标签
| 形态玩法 | 说明 | 举例 | 备注 |
|---|---|---|---|
| 娱乐测试 | 最终目的是获取测试结果，例如影音互动测试，答题测试等 | AI颜值评分、AI造型屋、录绕口令、录歌、影视测试、王者荣耀答题闯关 | |
| 游戏 | 偏游戏互动类型 | 测手速、华容道、模拟器 | |
| AI生成 | 图片的在线设计&编辑制作；文件、文案、视频的生成或转换 | 漫画脸制作、表情包制作、证件照生成、名片设计、logo设计、文件格式转换、翻译、足迹生成、对联生成 | |
| 实用工具 | 实用、娱乐小工具；例如日程表、智能检测、记事本等 | BMI计算、保质期计算、倒计时、记事本、日程表、智能检测、投票 | |
| 内容消费 | 电影档期、娱乐资讯、地址查询等 | 表情包、小说、影视、相声 | 注意版权问题 |
| 教育培训 | 泛知识类型 | Excel基础入门 | |
| 其他 | 其他以上未覆盖类型 |
内容标签
| 内容名称 | 说明 |
|---|---|
| 小说 | 长短篇小说资讯、阅读 |
| 漫画 | 漫画相关资讯、阅读 |
| 情感心理 | 情感、成长、职场技能 |
| 游戏 | 角色扮演、竞技游戏、动作游戏、射击游戏、游戏其他、解说游戏 |
| 影视综 | 影视剪辑、影视解说 普通综艺、脱口秀、其他综艺 |
| 二次元 | 二次元衍生、二次元内容、二次元资讯、二次元其他 |
| 美食 | 美食教程、评测、吃播、山野村食、美食知识、美食展示 |
| 萌宠 | 宠物猫、狗、其他动物、宠物资讯 |
| 亲子 | 母婴、儿童、亲子日常 |
| 旅游 | 旅行vlog、旅行攻略、旅行摄影、酒店/民宿测评、导游 |
| 颜值时尚 | 帅哥、美女人物随拍、录屏、生活记录；彩妆、护肤、穿搭、资讯 |
| 音乐 | 音乐演唱、西洋乐器、民族乐器、音乐知识 |
| 舞蹈 | 专业舞蹈、手势舞蹈、民族舞、广场舞 |
| 体育 | 竞技体育、水/雪上运动、极限运动、球类项目、体育运动文化 |
| 健身 | 专业健身、生活健身、健身知识 |
| 绘画 | 绘画知识、课程、画展相关信息等等 |
| 居家休闲 | 装修设计、生活窍门、家具家电、园艺花艺、手工diy 魔术、多米诺骨牌类、开箱、玩具、棋牌 |
| 科技财经 | 手机、电脑、电器、科技周边、行业资讯 投资理财、金融产品、财经新闻、财经知识、房产、实体经济 |
| 汽车 | 看车、选车、买车、用车、学车、汽车周边 |
| 其他 | ①片场演绎、明星资讯、明星访谈 ②剧情、演绎 ③医疗机构、医疗用品、健康 ④户外打野、赶海、农村生活、农业技术、农业资讯、国外泛三农 ⑤时政新闻、军事、军事 |
错误码
| Code | 描述 | 排查建议 |
|---|---|---|
| 0 | 成功 | |
| 4001015 | 参数错误 | |
| 4001010 | 系统错误 | |
| 4001002 | 未知错误 | |
| 4006000 | 没有设置小程序分佣比例的权限 请前往抖音开放平台->运营->小程序推广->小程序推广计划->直播任务管理, 设置小程序的分佣比例 | |
| 5501 | access_token不存在 | |
| 5502 | access_token不合法 | |
| 5503 | appid与access_token不一致 | |
| 5428 | 图片解析错误 | |
| 5423 | 图片格式错误 | |
| 5415 | 图片超出大小限制 | |
| 5414 | 图片尺寸不合法 | |
| 5422 | 处理图片超时 | |
| 5425 | 非法视频，请检查视频 | |
| 5410 | 任务名称长度不合法 | |
| 5481 | 任务名称不得包含特殊字符 | |
| 5482 | 任务名称不得包含敏感字符 | |
| 5408 | 锚点标题长度不合法 | |
| 5407 | 任务图标不能为空 | |
| 5404 | 任务描述长度不合法 | |
| 5405 | 任务结束时间必须大于 30 天 | |
| 5483 | 形态标签或内容标签不合法 | |
| 5406 | 小程序/小游戏落地页截图数量不合法 | |
| 5439 | start_page不合法 | |
| 5403 | 小程序/小游戏落地页参考视频数量不合法 | |
| 5427 | 该小程序/小游戏已经达到当天添加任务的次数限制 | |
| 5507 | 该任务状态为审核中，不允许编辑，请耐心等待审核结果 | |
| 5426 | 已有审核中/已上架的相同任务, 请勿重复提交。可自查“任务名称”或“小程序start_page”是否重复 | |
| 5433 | 小程序未开启任务台 (小程序未入驻) | |
| 5434 | 暂无权限 | |
| 5418 | 找不到对应的小程序 | |
| 5401 | app 类型不合法（非小程序） | |
| 5435 | 小程序未上线，暂无权限 (小程序已下架) | |
| 5438 | 小程序未上线，暂无权限 (小程序未上线) | |
| 5601 | 请先开通“直播间达人推广挂载”权限 | |
| 5484 | 限制任务发布中 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/taskbox/add_room_task/' \
--header 'Content-Type: application/json' \
--data-raw '{
"access_token": "080112184630766d356e30**********30652b6f45466b4147513d3d",
"appid": "tt20485*****76672b01",
"task_name": "测试的任务名称",
"start_page": "page/detail/detail?id=123",
"task_icon": "https://p3-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/01cefe0ce3c3479d845dcb861ca018b1~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718424829&x-signature=7vw6D8rEUIDZXHAd4veMedSjlLo%3D",
"room_title": "测试的直播间标题",
"task_end_time": 1709782399,
"task_desc": "任务描述: 東門之池，可以漚麻。彼美淑姬，可與晤歌。東門之池，可以漚紵。彼美淑姬，可與晤語。",
"form_tag": "娱乐测试",
"content_tag": "漫画",
"refer_videos": [
"https://v.douyin.com/SHAfHPu/",
"https://v.douyin.com/SHASjbd/"
],
"refer_ma_captures": [
"https://p3-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/1bcfc89de30f4b0fb2000d69f6d36d08~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718424958&x-signature=KA4V5kcK%2FnLtjz5HtfhNz06uce4%3D",
"https://p6-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/e840d9158f784733a9f0f27bd60ad433~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718425011&x-signature=zltShSxIkbLay7dlA1oR4KwoyPM%3D"
]
}'响应示例响应示例
200 - 成功示例
{
"error": 0,
"message": "SUCCESS",
"task_id": 72099269****8146361,
"task_url": "https://m.zjbyte.net/share/douyin/?token=e32199427d4ebe5b*****3b9a86784ab&share_channel=scan"
}
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Body 参数application/json