创建线索组件

我的收藏

使用该 OpenAPI，请确保您已知悉线索组件的内容以及配置效果，具体可参见：线索组件配置能力介绍

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

使用限制

•

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

•

业务场景：开发者可通过此 OpenAPI 创建对应的线索组件，后续可前往「控制台-能力-用户数据能力-身份数据-线索组件」页面中进行联调和测试，验证留资数据上报的准确性。

•

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

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

名称	类型	必填	描述
access-token	string	是	access_token 是小程序的全局唯一调用凭据。通过 getAccessToken 接口获取。服务商代调用场景，通过获取授权小程序接口调用凭据获取。注意是 access-token，不是 access_token。

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

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

{
    "err_no": 0,
    "err_msg": "success",
    "log_id": "xxxx",
    "data": {
        "config_id": "xxxx" // 线索组件的id，唯一标识
    }
}

{
    "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暂无权限	说明目前该接口还未对外开放，敬请期待