基础能力

联合授权

视频能力

线索组件

接口调用凭证

Web 化接入

隐私协议

流量主

小程序码与小程序链接

用户信息

抖音号绑定

小程序推广计划

短视频任务

直播间任务

内容安全

任务能力

客服

小程序券

触达与营销

支付

运营

生活服务

垂直行业

其它

更新专属任务达人

我的收藏

该接口用于修改小程序推广计划创建的专属任务的达人列表，目前支持添加或取消达人合作。

使用限制

达人关联的专属任务必须是非终止状态。

接口说明

•

一次请求可操作的达人数量不超过 10 个。

•

专属任务关联的达人（包含已取消合作的达人）数量最多不超过 200 个。

•

已投稿专属任务的达人不支持“取消合作”操作。

基本信息

名称	描述
HTTP URL	https://developer.toutiao.com/api/apps/taskbox/update_orient_talents/
HTTP Method	POST
Scope	无
权限要求	无

请求头

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

请求参数

Body

名称	类型	是否必填	描述	示例值
access_token	string	是	权限 token，获取接口（代开发服务商获取token的方式获取接口2）	0801121846315443627a326645433874682b7347326
appid	string	是	小程序id	ttf31985a46c214faf
task_id	number	是	小程序推广计划专属任务id	7218760632718443557
op_type	number	是	操作类型：1-添加达人，2-取消达人合作	1
douyin_ids	[]string	是	操作的达人抖音号列表，最多可一次性传10个	["lw1352552","9423515316"]
third_appid	string	否	第三方小程序appid（服务商使用的授权小程序）	abcdefgh1234562

请求示例

示例 1：为专属任务添加指定达人：

curl --location --request POST 'https://developer.toutiao.com/api/apps/taskbox/update_orient_talents/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_token": "0801121846315443627a326645433874682b7347326",
    "appid": "ttf31985a46c214faf",
    "douyin_ids": [
        "lw1352552",
        "9423515316"
    ],
    "op_type": 1,
    "task_id": 7218760632718443557
}'

示例 2：取消专属任务合作的达人：

curl --location --request POST 'https://developer.toutiao.com/api/apps/taskbox/update_orient_talents/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_token": "0801121846315443627a326645433874682b7347326",
    "appid": "ttf31985a46c214faf",
    "douyin_ids": [
        "lw1352552",
        "9423515316"
    ],
    "op_type": 2,
    "task_id": 7218760632718443557
}'

响应参数

名称			类型	是否必填	描述	示例值
error			number	是	错误码，0表示成功	0
message			string	是	错误信息，error非0时对应的错误信息文案提示，成功时为空字符串	“success”
log_id			string	是	链路追踪id，排查问题时提供该值	202303311900598DCDC833868FAC221F33
data			object	否	更新结果，error非0时会返回
	update_info_list		[]object	是	达人操作结果列表
		douyin_id	string	是	达人用户抖音号
		update_result	string	是	添加达人成功时，返回“请求成功，已添加”；取消合作成功时候，返回“请求成功，已取消”；其他情况下均为异常情况，返回具体的异常原因	请求成功，已添加

响应示例

正常示例

{
  "data": {
    "update_info_list": [
      {
        "douyin_id": "lw1352552",
        "update_result": "请求成功，已添加"
      }
    ]
  },
  "message": "success",
  "error": 0
}

异常示例

{
  "data": {
    "update_info_list": [
      {
        "douyin_id": "lw1352552",
        "update_result": "请求失败，和该达人的合作已取消，无法重复取消"
      }
    ]
  },
  "message": "success",
  "error": 0
}

错误码

HTTP 状态码	错误码	描述	排查建议
200	0	请求操作成功
	5501	accessToken不存在
	5502	accessToken不合法	1.确认access_token的获取接口是否正常 2.确认access_token是否完整上传
	5503	appID与token不一致	请求的appid参数与access_token不对应
	5442	任务不存在	检查任务id是否为专属任务
	5591	任务已终止，请重新创建	已终止的专属任务不能添加或取消达人合作
	5592	操作达人数量不合法，请调整后重试	douyin_ids长度为0或超过10个
	4001010	Service Unavailable	系统内部错误，请重试
	4001015	Request Paramter Error	1.检查请求参数是否符合上述接口文档的要求 2.根据返回的message检查对应字段合法性