品牌采用供应商 V2 接口

用于 B02「品牌详情页_采用供应商」。根据餐饮品牌 ID 查询其采用的供应商，卡片数据与供应商搜索 V2 使用相同的有效关联口径。

请求

GET /api/bs_v2/brand/adopt_supplier

Query 参数	类型	必填	默认值	说明
`brand_id`	integer	是	无	餐饮品牌 ID，必须大于 0
`current_page`	integer	否	1	页码，从 1 开始
`page_size`	integer	否	10	每页 1—100 条

仅接受以上三个参数。无有效关联、品牌不存在或品牌已下架时，返回 items: [] 和 total: 0；不自动新增供应商。

排序与有效数据

排序依次比较：已认证供应商优先 → 有效服务品牌数量降序 → 供应商 ID 降序。仅当前一条件相同时比较后一条件。认证状态只有 is_authenticate=1 视为已认证，0 和 null 均视为未认证。

采用关系来自 rel_supplier_brand，要求关系 status=1。查询品牌要求 dim_brand.brand_type=0、status=1、brand_bs_status=1；供应商要求 brand_type=1、status=1、brand_bs_status=1。同一品牌到同一供应商的重复关系只返回一条供应商。

服务品牌数统计该供应商全部有效服务品牌，不限于请求的品牌：有效关系 status=1，关联品牌 dim_brand.status=1，并按服务品牌 ID 去重。停用关系和已下架服务品牌不计数。排序在全量去重后完成，再分页。

成功响应

HTTP 200；data 是 JSON 对象。

{
  code: 200,
  message: success,
  data: {
    current_page: 1,
    page_size: 10,
    total: 1,
    has_more: false,
    items: [
      {
        id: 4,
        name: 森盛食品,
        brand_logo: https://example.com/supplier-logo.png,
        is_authenticate: 1,
        province_id: 19,
        province_name: 广东省,
        city_id: 199,
        city_name: 广州市,
        partner_brand_count: 2,
        categories: [
          {
            master_category_id: 201,
            master_category_name: 食材类,
            second_category_id: 202,
            second_category_name: 肉禽蛋,
            category_sort: 1
          }
        ],
        partner_brands: [
          {brand_id: 100, brand_name: 示例品牌, brand_logo: https://example.com/brand-logo.png}
        ]
      }
    ]
  }
}

total 是去重后的全部供应商数量；越界页 items 为空但保留 total。partner_brand_count 是有效服务品牌总数，partner_brands 返回全部有效品牌并按品牌 ID 升序排列；示例只展示了一项。无分类、地区或服务品牌时分别返回空数组、null 地区字段或 0。所在地省市来自同一家有效关联企业。

参数缺失、非整数、页码越界、每页数量越界或传入其他参数时返回 HTTP 400。业务系统按 HTTP 状态和 code 判断结果；供应商卡片 id 可用于打开供应商详情页。

验证

隔离 SQLite 用例：测试代码。覆盖认证优先、服务品牌数、ID 并列、重复关系、停用数据、分页、卡片资料及 Query 参数。实际 MySQL 延迟和线上数据正确性仍需联调确认。

品牌采用供应商

品牌采用供应商 V2 接口

请求

排序与有效数据

成功响应

验证

请求参数

请求示例代码

返回响应

品牌采用供应商

品牌采用供应商 V2 接口#

请求#

排序与有效数据#

成功响应#

验证#

请求参数

请求示例代码

返回响应

品牌采用供应商 V2 接口

请求

排序与有效数据

成功响应

验证