Skip to content

查询商品列表

分页查询指定商户的商品/服务列表。

请求

GET /open-api/v1/products

请求参数

参数类型必填说明
merchantIdlong商户 ID,不传则返回所有授权商户的商品
categoryIdlong分类 ID
pageNoint页码,默认 1
pageSizeint每页条数,默认 10

响应

响应参数

字段类型说明
listarray商品列表
list[].idlong商品 ID
list[].productNamestring商品名称
list[].categoryNamestring分类名称
list[].priceint价格(分)
list[].originalPriceint原价(分)
list[].imageUrlstring主图
list[].statusint状态:0-上架 1-下架
totallong总记录数

响应示例

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 4001,
        "productName": "深层清洁护理",
        "categoryName": "面部护理",
        "price": 29900,
        "originalPrice": 39900,
        "imageUrl": "https://cdn.example.com/products/4001.jpg",
        "status": 0
      }
    ],
    "total": 1,
    "pageNo": 1,
    "pageSize": 10
  }
}

商数通开放平台