`list_suppliers`

分页查询供应商（店铺）列表，可按关键词搜索店铺名、主营产品等。返回店铺名称、类型（Manufacturer/Trader 等）、国家省市、地址、评分、代表商品等，用于「找供应商」「按地区筛店铺」。

英文描述

Paginated supplier/store list on xchemi. Filter by keyword. Use to find suppliers by region or product.

文档更新：2026-06-23T10:00:00+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`keyword`	选填	string	（选填，示例中省略）
`page_number`	选填	integer	1
`page_size`	选填	integer	20

响应参数

参数名	参数说明	数据类型	样例数据
`code`	业务状态码，0 表示成功	integer	0
`msg`	状态说明	string	操作成功！
`data.pageData`	分页数据数组	array	[{"supplierId": "SUP001", "supplierName": "某某化工供应商", "country": "CN"}]
`data.pageData[].supplierId`	供应商 ID	string	SUP001
`data.pageData[].supplierName`	供应商名称	string	某某化工供应商
`data.pageData[].country`	国家/地区	string	CN
`data.totalSize`	总记录数	integer	100
`data.pageNumber`	当前页码	integer	1
`data.pageSize`	每页条数	integer	20

响应状态说明

状态	说明
`success`	调用成功，返回业务数据
`failed`	参数错误、后端业务错误或系统异常
`denied`	API Key 无效、无权限、RBAC/菜单拒绝等
`session_expired`	用户 token 无效或过期（如 code=-99）

请求示例

{
  "page_number": 1,
  "page_size": 20
}

响应示例

{
  "code": 0,
  "msg": "操作成功！",
  "data": {
    "pageData": [
      {
        "supplierId": "SUP001",
        "supplierName": "某某化工供应商",
        "country": "CN"
      }
    ],
    "totalSize": 1,
    "pageNumber": 1,
    "pageSize": 20
  }
}