更新线索组件

我的收藏

开发者在创建对应的线索组件之后，可通过此 OpenAPI 修改对应的线索组件，效果与官网对应页面中的修改功能相同。

使用限制

•

开发者需申请开通线索组件能力，开通此能力有类目要求，您可查看线索组件能力介绍中的准入类目要求。

•

业务场景：开发者可通过此 OpenAPI 修改对应的线索组件，注意此次修改会清空之前的激活状态，后续可前往「抖音开放平台-控制台-小程序-运营-流量配置-线索组件」页面中重新进行联调和测试，并验证数据上报的准确性。

•

地区编号：地区编号（链接可能失效，以国家公示的六位地区编码为准即可）。

名称	描述
HTTP URL	https://developer.toutiao.com/api/apps/v1/capacity/update_clue_component_info
HTTP Method	POST
Scope	无
权限要求	服务商代调用场景下，需商家授予运营管理权限集

名称	类型	必填	描述
access-token	string	是	token获取接口（其中服务商代调用场景的token获取接口）（注意access与token的中间不是下划线）

名称	类型	是否必填	描述	默认值
config_id	string	是	要更新的线索组件的id（唯一标识）	无默认值，开发者自行填写
config_name	string	是	要创建的线索组件的名称（配置名称长度不能大于20）	无默认值，开发者自行填写
region	string	否	地区编号，必须精确到区/县，地区编号为国家政务公示网上所显示的编号 region和region_list必填一个	无默认值，开发者自行填写
region_list	list<string>	否	地区编号列表，必须精确到区/县，地区编号为国家政务公示网上所显示的编号 region和region_list必填一个	无默认值，开发者自行填写
category_id	string	是	小程序的服务类目id，格式为"xxx,xxx,xxx"，需要传小程序已审核通过的服务类目id，获取小程序已设置的服务类目见获取服务类目	无默认值，开发者自行填写

{
  "config_id": "xxx", // 线索组件id 
  "config_name": "线索组件测试1", // 线索组件名称
  "region": "110101", // 北京市东城区
  "category_id": "8,9,12"
}

{
    "err_no": 0,
    "err_msg": "success",
    "log_id": "xxxx",
    "data": {
    }
}

{
    "err_no": -1,
    "err_msg": "系统错误",
    "log_id": "xxxx",
    "data": {
    }
}

HTTP 状态码	错误码	描述	排查建议
200	11009	参数不合法或缺少参数	检查body中的字段名及对应值类型是否正确
200	11016	access_token不正确或已过期	重新生成access_token或刷新access_token
200	11001	app_id无法解析	重试，若重试不行则重新生成access_token，还不行可使用log_id向内部开发同学反馈
200	40036	授权小程序未授予对应的接口权限	重新授予相关权限后，刷新access_token重试
200	-1	系统错误	重试，多次重试失败可使用log_id向内部同学反馈
200	30001	参数不能为空	请检查body中的字段是否有空参
200	30002	参数不合法，请确认地区编号，线索组件名称，线索组件id等是否满足基本要求	请确认地区编号是否与国家公示网上的保持一致以及是否精确到了区/县；请检查线索组件名称的长度是否超过了20个字；请检查传入的线索组件id是否正确
200	30003	填写的类目不正确	先确认类目的格式是否为xx,xx,xx，然后确认填写的类目是否是小程序已审核通过的类目，最后确认填写的类目是否在指定的行业类目中
200	30004	线索组件的创建数量已达上限	一个小程序最多创建20个线索组件
200	30005	此appId暂无权限	说明小程序非定向邀约小程序