查询商品规格库存
通过输入品牌名称进行模糊查询，支持品牌中文名(拼音)、英文名，并返回品牌信息
本接口适用于通过前缀匹配的形式对品牌信息，例如想要“安踏”，可以通过搜索“安”来查询，但是搜索“踏”是无法找到的。
注意点：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 |
2. 请求示例代码(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
}
3. 返回结果如下：
{
"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
文档更新时间: 2024-05-22 14:22 作者：JSL
