获取商品列表

注:本文已停止更新,请移步至新开发文档获取最新信息

open.goods.list.get

全渠道批量获取自建商城的商品数据。

使用场景

路径导航:管家婆全渠道 --> 商品 --> 对应关系
触发接口:选择网店,选择卖家类目,点击查询

请求参数

参数 类型 说明
CatID string 分类编号
GoodsName string 商品名称模糊查询
OuterID string 规格商家编码(搜索商品的商家编码)
Status string 0: 库存中 1:出售中 2:全部
Offset long 偏移量/不是页码 (size=20,offset=80 即是取81-100的记录)
Size long 每页条数

请求示例

{
	"CatID": "",
	"GoodsName": "",
	"OuterID": "",
	"Status": "",
	"Offset": 0,
	"Size": 50
}

响应参数

参数 类型 说明
code string 响应代码
message string 响应消息
data object 响应数据

data 数据结构

参数名 类型 说明
total int 列表总数
items array 数据列表

items 数据结构

参数名 类型 说明
goodsid string 本地产品ID
goodsname string 产品名称
goodscode string 产品Code
imageurl string 产品对应的图片
isonsale int 在售状态标识:1=在售,0=下架
quantity int 产品库存数量
outerid string 外部产品ID
skus array 商品的SKU详情列表

skus 数据结构:

参数名 类型 说明
outerid string SKU外部ID
quantity int 数量
skuID string 属性ID
skuname string 属性名称
skucode string 属性编码
barcode string 条码
imageurl string sku对应的图片

响应示例

{
  "code": "success",
  "message": "成功",
  "data": {
    "total": 1,
    "items": [
      {
        "goodsid": "G123456",
        "goodsname": "无线蓝牙耳机",
        "goodscode": "BT-001",
        "imageurl": "http://example.com/images/bt-headphones.jpg",
        "isonsale": 1,
        "quantity": 50,
        "outerid": "E123456",
        "skus": [
          {
            "outerid": "E123456-SKU01",
            "quantity": 25,
            "skuid": "SKU12345",
            "skuname": "黑色",
            "skucode": "SKUCODE-BLACK",
            "barcode": "BARCODE123456789",
            "imageurl": "http://example.com/images/bt-headphones-black.jpg"
          }
        ]
      }
    ]
  }
}

错误码

2024-11-13
0 0