通过前缀匹配召回品牌信息
一、请求参数
通过输入品牌名称进行模糊查询，支持品牌中文名(拼音)、英文名，并返回品牌信息 本接口适用于通过前缀匹配的形式对品牌信息，例如想要“安踏”，可以通过搜索“安”来查询，但是搜索“踏”是无法找到的。 注意点：1. 召回的第一个为品牌名称严格匹配项。
-
单次召回数量最多为10个。
-
支持中文名称或英文名称，但不可以两个名称一起输入来查询
-
不支持特殊符号，例如“/”，“ ”，“·”，以及除中英文外的语言
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 抖店的账号，对应蜂巢授权返回doudianseller字段 |
| sign | String | 是 |
业务参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| query | String | 是 | apple | 前缀匹配的品牌名 |
| user_id | Int64 | 是 | 0 | 用户ID，可用默认值0 |
| +filter_info | Struct | 否 | - | 过滤用参数，不填则是全量召回 |
| - brand_ids | List | 否 | [202132132342, 213123443543] | 品牌ids |
| - brand_category | List | 否 | [20220] | 品牌类别 |
| - status | Int64 | 否 | 1 | 品牌状态: 1. 在线 2. 离线 |
| - related_ids | List | 否 | [12123123123, 4323423423] | 品牌商标关联Id |
| - trade_mark_ids | List | 否 | [“21312323134”] | 商标IDs |
| - audit_status | List | 否 | [2] | 废弃字段，请勿填写: 1. 审核中 2. 审核通过 3. 审核拒绝 4. 送审失败 |
| read_old | Bool | 是 | false | 是否读取老数据，默认为false |
| biz_types | List | 是 | [0] | 业务线类型: 0. 国内品牌 1. 跨境品牌 3. 广告 |
| enable_deduplicate | Bool | 是 | true | 是否去重，一般选择true |
| +extra_config | Struct | 否 | - | 额外配置，无特殊需求请按描述填写 |
| - use_origin_brand_info | Bool | 否 | false | 是否忽略去重 使用原始品牌信息，默认取false |
| - use_brand_info | Bool | 否 | false | 是否忽略新旧映射 使用老品牌信息，默认取false |
| - use_brand_name_deduplicate | Bool | 否 | true | 使用品牌名去重，需要和抖店一致请取true |
二、请求示例代码
Java
请求示例代码
@Test public void DDBrandGetSug() throws Exception { Map<String, Object> data = new HashMap<String, Object>(); data.put("appid", Config.AppId); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("seller_nick", Config.DDSellerNick);
data.put("query", "a"); data.put("user_id", "0"); data.put("read_old", "false"); data.put("biz_types", "[0]"); data.put("enable_deduplicate", "true");
// data.put("filter_info", "{\n" +// " \"brand_ids\": [\n" +// " 202132132342,\n" +// " 213123443543\n" +// " ],\n" +// " \"brand_category\": [\n" +// " 20220\n" +// " ],\n" +// " \"status\": \"1\",\n" +// " \"related_ids\": [\n" +// " 12123123123,\n" +// " 4323423423\n" +// " ],\n" +// " \"trade_mark_ids\": [\n" +// " \"21312323134\"\n" +// " ],\n" +// " \"audit_status\": [\n" +// " 2\n" +// " ]\n" +// " }");
// data.put("extra_config", "{\n" +// " \"use_origin_brand_info\": \"false\",\n" +// " \"use_brand_info\": \"false\",\n" +// " \"use_brand_name_deduplicate\": \"true\"\n" +// " }");
data.put("sign", Sign(data,Config.AppSecret)); // 调用服务API String resp = doHttpRequest(Config.DDBrandGetSug, data); System.out.println(resp); }参数filter_info对象
{ "brand_ids": [ 202132132342, 213123443543 ], "brand_category": [ 20220 ], "status": "1", "related_ids": [ 12123123123, 4323423423 ], "trade_mark_ids": [ "21312323134" ], "audit_status": [ 2 ]}参数extra_config对象
{ "use_origin_brand_info": false, "use_brand_info": false, "use_brand_name_deduplicate": true}三、返回结果
{ "code": 0, "message": "ok", "data": { "sug_list": [{ "audit_status": 2, "biz_type": 0, "brand_alias": [""], "brand_id": 1435243494, "brand_name_c_n": "a", "brand_name_e_n": "a", "create_timestamp": 1609781757, "extra": {}, "level": 0, "logo": "", "status": 1, "update_timestamp": 1701772439 }, { "audit_status": 2, "biz_type": 0, "brand_alias": [""], "brand_id": 1685754040, "brand_name_c_n": "A", "brand_name_e_n": "", "create_timestamp": 1657177806, "extra": {}, "level": 0, "logo": "", "status": 1, "update_timestamp": 1701773281 }, { "audit_status": 2, "biz_type": 0, "brand_alias": [""], "brand_id": 164110641, "brand_name_c_n": "", "brand_name_e_n": "a2", "create_timestamp": 1609057755, "extra": {}, "level": 4, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/ecc6c6b997ed46dfb422264b28876c3f~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701772444 }, { "audit_status": 2, "biz_type": 0, "brand_alias": ["奥碧虹", "奥尔滨", "albion/奥尔滨"], "brand_id": 1948477262, "brand_name_c_n": "澳尔滨", "brand_name_e_n": "ALBION", "create_timestamp": 1609057711, "extra": {}, "level": 3, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/c2d3b0f6fc9c437ba1af5300902a77f9~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701772322 }, { "audit_status": 2, "biz_type": 0, "brand_alias": ["A.O.SMITH/史密斯"], "brand_id": 723878377, "brand_name_c_n": "史密斯", "brand_name_e_n": "A.O.Smith", "create_timestamp": 1609057718, "extra": {}, "level": 3, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/a710025075a7417e971fcaaa9259a4a6~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701772916 }, { "audit_status": 2, "biz_type": 0, "brand_alias": ["奥克斯", "AUX"], "brand_id": 1933725265, "brand_name_c_n": "奥克斯", "brand_name_e_n": "AUX", "create_timestamp": 1609057764, "extra": {}, "level": 4, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/c8782466ea394c9cb73314ee78ae2580~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701775093 }, { "audit_status": 2, "biz_type": 1, "brand_alias": ["air jordan", " 乔丹"], "brand_id": 2109793687, "brand_name_c_n": "", "brand_name_e_n": "AIR JORDAN", "create_timestamp": 1623228969, "extra": {}, "level": 1, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/5c89d6b666ee499c821341800b6f62f8~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1713431954 }, { "audit_status": 2, "biz_type": 0, "brand_alias": ["箭牌", "ARROW", "ARROW/箭牌卫浴•瓷砖"], "brand_id": 1742806262, "brand_name_c_n": "箭牌", "brand_name_e_n": "ARROW", "create_timestamp": 1609057747, "extra": {}, "level": 4, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/c4a1a95051fb48d1aad3224d830479cc~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701774272 }, { "audit_status": 2, "biz_type": 0, "brand_alias": [""], "brand_id": 270913920, "brand_name_c_n": "安视优", "brand_name_e_n": "ACUVUE", "create_timestamp": 1609057746, "extra": {}, "level": 3, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/179588c2de6f4206bd10c90296cda3ed~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701773051 }, { "audit_status": 2, "biz_type": 0, "brand_alias": ["雅漾"], "brand_id": 1824937599, "brand_name_c_n": "雅漾", "brand_name_e_n": "Avene", "create_timestamp": 1609057715, "extra": {}, "level": 4, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/33ab51d4e7654c8b8dc61e3c169801f0~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701775231 }, { "audit_status": 2, "biz_type": 0, "brand_alias": ["aimer nyc", "aimer"], "brand_id": 218466380, "brand_name_c_n": "爱慕", "brand_name_e_n": "AIMER", "create_timestamp": 1609057733, "extra": {}, "level": 4, "logo": "http://p3-thunder.ecombdimg.com/tos-cn-i-9tc1r98m18/352d8cc1cd904981b9ad11bb53313e93~tplv-9tc1r98m18-image.image", "status": 1, "update_timestamp": 1701771017 }] }}说明： code为0表示成功，非0为失败，message会包含失败原因。返回字段说明见文档 https://op.jinritemai.com/docs/api-docs/14/1436