获取商品列表
GET /wms/goodsList
# 请求参数
请求参数列表:
| 参数名称 | 必须 | 描述 | 类型 |
|---|---|---|---|
| goods_ids | 否 | 商品ID,多个用逗号分隔 | String |
| sku | 否 | 商品SKU | String |
| limit | 否 | 数据条数,不传默认为20 | Number |
| page | 否 | 页码,不传默认第1页 | Number |
| since | 否 | 起始时间,示例2024-03-20 00:00:00 | String |
?goods_ids=190,191,192
?sku=SKU123
?limit=10&page=1
?since=2024-08-01 00:00:00
# 返回信息
接口返回商品列表的json数据
响应参数列表:
| 参数名称 | 描述 |
|---|---|
| goods_id | 商品ID |
| goods_code | 商品代码 |
| goods_sku | 商品SKU |
| cn_name | 中文名称 |
| en_name | 英文名称 |
| goods_img | 商品图片URL |
| goods_des | 商品描述 |
| declare_value | 申报价值 |
| goods_length | 商品长度(英寸) |
| goods_width | 商品宽度(英寸) |
| goods_height | 商品高度(英寸) |
| goods_weight | 商品重量(磅) |
| hscode | 海关编码 |
| coo | 原产国代码 |
| brand | 品牌 |
| is_take_battery | 是否含电池(0:否,1:是) |
| min_stock_warning | 最低库存预警数量 |
| product_sell_url | 商品销售链接 |
| goods_cate_id | 商品分类ID |
| status | 商品状态 |
| created_at | 创建时间 |
| updated_at | 更新时间 |
完整响应数据示例:
{
"code": 200,
"msg": "success",
"data": [
{
"goods_id": 190,
"goods_code": "SKU123456",
"goods_sku": "SKU123456",
"cn_name": "更新产品",
"en_name": "Updated Product",
"goods_img": "",
"goods_des": "这是测试商品描述",
"declare_value": 100,
"goods_length": "12.000",
"goods_width": "6.000",
"goods_height": "3.000",
"hscode": "123456",
"coo": "CN",
"brand": "NewBrand",
"is_take_battery": 0,
"min_stock_warning": 5,
"product_sell_url": "https://product.example.com",
"goods_cate_id": 12,
"created_at": "2025-08-07 04:34:44",
"updated_at": "2025-08-07 16:34:44",
"status": 1,
"goods_weight": 1.5
}
],
"total": 1,
"per_page": 20,
"current_page": 1,
"last_page": 1
}