更新直播间任务

我的收藏

建议接入v2接口：重新提交任务基础信息-v2

该接口用于更新开黑订单相关的直播间任务。

使用限制

无。

接口说明

无。

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/taskbox/update_task/
HTTP Method	POST
Scope	无
权限要求	•需要在开发者平台上开通任务台相关功能。

请求头

名称	类型	必填	描述
content-type	string	是	固定值 "application/json"

请求参数

Body

属性	类型	必填	描述	审核注意备注
anchor_title	string	是	直播间标题，最多14个字符
appid	string	是	小程序的appid，需要app的类型为小程序
task_end_time	i64	是	任务结束时间，秒级时间戳。开始时间与结束时间相差要求大于30天
refer_ma_captures	string[]	是	小程序对应页面截图, 0~3张, 宽为312, 高为444, 大小不超过2M
refer_videos	string[]	否	示例视频1-5个，校验是可以打开的视频，如被删除或其他原因则不展示会审核视频内容、视频锚点与任务的相关性，低质/无意义/录屏/不含小程序锚点会审核不通过	示例视频, 0~5个, 从移动端复制视频链, 正确格式为: https//v.douyin.com/xxxxxxx/ 视频需包含任务对应的小程序锚点！校验是可以打开的视频，如被删除或其他原因则不展示会审核视频内容、视频锚点与任务的相关性，低质/无意义/录屏/不含小程序锚点会审核不通过
start_page	string	是	小程序页面地址，包含path和query，path不得以 "/" 开头	示例：page/detail/detail?id=1
task_desc	string	是	任务要求<=500字，条数不限。仅支持纯文本输入，不可包含html标签。	举例1.产品介绍：该产品是一个XX类型的小程序，可以XXX。2.达人视频内需添加与小程序页面相关的内容，杜绝生硬植入。3.达人视频内容表现积极向上，禁止出现恶俗、违背公序良俗类内容或品牌负面4.视频原创，拒绝拼接，搬运，虚假骗互动内容。注意：任务台的方案只能计算小程序内收入，如果是iOS虚拟支付的，走了小店的那部分无法计费，需要开发者在产品说明中明确写出来如：请注意：该小程序内iOS端的订单收入不计入分成收入，仅计算安卓端订单收入。
task_icon	string	是	尺寸为512*512的当前任务图标，大小不超过200KB，支持PNG,JPG格式不允许出现留边的情况，图片必须铺满	图标的链接
task_name	string	是	任务名称长度：限制在18个字以内不得包含特殊字符，除[、，、。、！、？、“、”、《、》「、」、]以外不得包含敏感字符，例如“全网第一”	任务名称请勿包含公司名称！任务标题相同，任务时间重叠。即为重复上传任务，不支持上传同一个小程序，上传相似标题、相同页面地址的任务，会审核不通过
task_tags	string[]	是	任务标签开发者勾选两个维度的标签：形态+内容内容，成为数组的两个元素	参考任务创建接口的任务标签字段说明必须按表里的填，不要自己命名！
access_token	string	是	权限 token，获取接口（代开发服务商获取token的方式获取接口2）
task_id	number	是	任务ID，创建接口返回

请求示例

curl -H 'Content-Type:application/json' \
-d '{
  "task_id": 72099269*****146361,
  "anchor_title": "测试更新直播间标题",
  "appid": "tt20485*****76672b01",
  "task_end_time": 1709782399,
  "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"
  ],
  "start_page": "page/detail/detail?id=1",
  "task_desc": "東門之池，可以漚麻。彼美淑姬，可與晤歌。東門之池，可以漚紵。彼美淑姬，可與晤語。",
  "task_icon": "https://p3-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/01cefe0ce3c3479d845dcb861ca018b1~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718424829&x-signature=7vw6D8rEUIDZXHAd4veMedSjlLo%3D",
  "task_name": "测试更新任务名称",
  "task_tags": [
    "娱乐测试",
    "漫画"
  ],
  "refer_videos": [
    "https://v.douyin.com/SHAfHPu/",
    "https://v.douyin.com/SHASjbd/"
  ],
  "access_token": "080112184630767670424e6b65*****c364b536c59797a6554513d3d"
}
' \
https://developer.toutiao.com/api/apps/taskbox/update_task/

响应参数

返回值为 JSON 形式，其中包括如下字段：

属性	数据类型	说明
error	number	错误码，0 是成功，其它为异常
message	string	成功为"success", 错误为具体 message
data	Json	包含任务id，参考下文

data 如下：

属性	数据类型	说明
task_id	i64	任务id

响应示例

正常示例

{
    "message": "success",
    "error": 0,
    "data": {
        "task_id": 72099269*****146361
    }
}

异常示例

{
  "data": {
    "task_id": 72099269*****146361
  },
  "error": 4006000,
  "message": "请前往抖音开放平台->运营->小程序推广->小程序推广计划->直播任务管理, 设置小程序的分佣比例"
}

错误码

当请求失败时，会返回非 0 的 error，错误信息会携带在 message 中，错误码含义如下：

Code	描述	排查建议
0	成功
4001015	1.参数错误 2.html标签不可用，任务介绍仅支持纯文本输入	1.请确认入参是否规范 2.请检查task_desc是否包含html标签
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	限制任务发布中