供应商搜索
开发中
GET
api/bs_v2/supplier/query
供应商搜索 V2 接口说明
接口信息
| 项目 | 说明 |
|---|---|
| 方法 | GET |
| 路径 | /api/bs_v2/supplier/query |
| 请求参数位置 | Query String |
| 成功响应类型 | application/json; charset=utf-8 |
| 用途 | 供应商搜索页签，以及“全部”页签中的供应商结果区块共用 |
Query 参数
| 参数 | 类型 | 必填 | 默认值 | 约束 | 说明 |
|---|---|---|---|---|---|
keyword | string | 是 | 无 | 最长100字符；去除空白后不能为空 | 搜索词。匹配供应商名称、分类名称、产品名称和服务品牌名称 |
current_page | integer | 否 | 1 | 大于等于1 | 当前页，从1开始 |
page_size | integer | 否 | 10 | 1—100 | 每页条数 |
is_authenticate、分类 ID、brand_str_id 等筛选参数不适用于本接口；传入未识别参数会触发参数校验错误。成功响应
200，响应体是 JSON 对象。成功体中的 data 是对象，不是 JSON 字符串。响应 JSON 文本按单值字段在前、多值字段在后的顺序输出；客户端仍应按字段名读取，不要依赖对象键顺序。{
"code": 200,
"message": "success",
"data": {
"current_page": 1,
"page_size": 10,
"total": 1,
"has_more": false,
"visit_stat_date": "2026-10-11",
"items": [
{
"id": 131711,
"name": "tigertop 虎拓设计",
"brand_logo": "https://example.com/logo.png",
"is_authenticate": 1,
"match_source": "supplier_name",
"province_id": null,
"province_name": null,
"city_id": null,
"city_name": null,
"partner_brand_count": 1,
"name_highlight": [
0,
13
],
"categories": [
{
"master_category_id": 184,
"master_category_name": "设备用品",
"second_category_id": 213,
"second_category_name": "包材用品",
"category_sort": 1
}
],
"partner_brands": [
{
"brand_id": 36,
"brand_name": "巴比",
"brand_logo": "https://example.com/partner-logo.png"
}
]
}
]
}
}响应字段
分页对象：data
| 字段 | 类型 | 说明 |
|---|---|---|
items | array | 当前页供应商卡片；没有结果时为空数组 |
total | integer | 全部匹配供应商数，按供应商 ID 去重，在分页前统计 |
current_page | integer | 实际请求页码 |
page_size | integer | 实际请求每页条数 |
has_more | boolean | 是否还有下一页 |
visit_stat_date | string / null | 访问量快照统计截止日期，格式 YYYY-MM-DD；暂无完整批次时为 null |
供应商卡片：data.items[]
| 字段 | 类型 | 说明 |
|---|---|---|
id | integer | 供应商 ID。同名但 ID 不同的供应商分别返回 |
name | string | 供应商名称 |
brand_logo | string / null | 供应商 Logo URL |
is_authenticate | integer / null | 认证状态；用于排序和展示，不作为请求筛选条件 |
match_source | string | 最终采用的命中来源：supplier_name（供应商名称）、category（分类）、product（产品）、partner_brand（服务品牌） |
name_highlight | array [start, end] / null | 名称命中区间；start 从0开始，end 不包含在区间内。只有命中供应商名称时返回区间，命中其他来源时为 null |
categories | array | 分类列表，沿用分类顺序 |
province_id | integer / null | 所选企业所在地省份 ID |
province_name | string / null | 所选企业省份名称 |
city_id | integer / null | 所选企业所在地城市 ID |
city_name | string / null | 所选企业城市名称 |
partner_brand_count | integer | 有效服务品牌总数 |
partner_brands | array | 全部有效服务品牌，按 brand_id 升序去重排序；无数据时为空数组 |
categories[] 字段：master_category_id、master_category_name、second_category_id、second_category_name、category_sort。对应分类失效或不存在时，相应 ID 和名称可能为 null。partner_brands[] 字段：brand_id、brand_name、brand_logo。返回全部有效服务品牌，按 brand_id 升序排列并按 ID 去重；数组长度与 partner_brand_count 一致。搜索和排序行为
match_source 返回该供应商按排序规则最终采用的最优命中来源；同一供应商命中多个来源时，仅返回优先级最高的来源。枚举值为 supplier_name、category、product、partner_brand。mai、maidanglao、danglao，不匹配 ma、aidang、dangl、mdl。items 为空，total 保持完整总数。name_highlight 是原始名称上的字符区间，适合前端分段渲染；不要将服务端数据拼成 HTML 后直接插入页面。null。参数错误
keyword、关键字去空白后为空、关键字超过100字符、页码小于1、每页数量不在1—100之间或传入未知参数时，请求会被拒绝。错误由项目统一异常处理返回；客户端应按非成功 HTTP 状态及错误响应处理，不要把错误响应当成成功的 data.items。业务系统接入注意事项
data 是对象。visit_stat_date 为 null 表示当前没有可用的完整访问量批次。缺失供应商的访问量按0参与排序。请求参数
Query 参数
请求示例代码
返回响应
修改于 2026-10-12 08:54:10