`list_home_goods`

分页查询国际站首页或平台级商品列表，支持关键词、店铺 ID 等筛选。返回 SKU、商品名、CAS、单价、包装、产地、店铺、图片等商品卡片信息，适用于「找货」「比价」「按 CAS 搜商品」。

英文描述

Paginated home/platform product list on xchemi intershop. Filter by keyword, store_id. Use for product discovery, CAS search, price comparison.

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

请求参数

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

响应参数

参数名	参数说明	数据类型	样例数据
`code`	业务状态码，0 表示成功	integer	0
`msg`	状态说明	string	操作成功！
`data.pageData`	分页数据数组	array	[{"goodsId": "G001", "goodsName": "工业级乙醇", "storeName": "ChemStore"}]
`data.pageData[].goodsId`	商品 ID	string	G001
`data.pageData[].goodsName`	商品名称	string	工业级乙醇
`data.pageData[].storeName`	店铺名称	string	ChemStore
`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": [
      {
        "goodsId": "G001",
        "goodsName": "工业级乙醇",
        "storeName": "ChemStore"
      }
    ],
    "totalSize": 1,
    "pageNumber": 1,
    "pageSize": 20
  }
}