获取商品列表
接口调用请求说明
时间范围 create_time
和 update_time
同时存在时,以 create_time
的范围为准
http请求方式:POST
https://api.weixin.qq.com/shop/spu/get_list?access_token=xxxxxxxxx
请求参数示例
{
"status": 5, // 选填,不填时获取所有状态商品
"start_create_time": "2020-12-25 00:00:00", // 选填,与end_create_time成对
"end_create_time": "2020-12-26 00:00:00", // 选填,与start_create_time成对
"start_update_time": "2020-12-25 00:00:00", // 选填,与end_update_time成对
"end_update_time": "2020-12-26 00:00:00", // 选填,与start_update_time成对
"page": 1,
"page_size": 10, // 不超过100
"need_edit_spu": 1 // 默认0:获取线上数据, 1:获取草稿数据
}
回包示例
{
"errcode": 0,
"errmsg":"ok",
"total_num": 20,
"spus":
[
{
"out_product_id": "1234566",
"title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
"path": "pages/productDetail/productDetail?productId=2176180",
"head_img":
[
"http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
],
"desc_info":
{
"desc": "xxxxx",
"imgs":
[
"http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
]
},
"third_cat_id": 6666,
"brand_id": 2100000000,
"create_time": "2020-12-25 00:00:00",
"update_time": "2020-12-26 00:00:00",
"skus":
[
{
"out_product_id": "1234566",
"out_sku_id": "1024",
"thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
"sale_price": 1300,
"market_price": 1500,
"stock_num": 100,
"sku_code": "A24525252",
"barcode": "13251454",
"sku_attrs":
[
{
"attr_key": "选择颜色",
"attr_value": "红蓝主机"
},
{
"attr_key": "选择套装",
"attr_value": "主机+保护套"
}
]
}
]
},
...
]
}
请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|
status | number | 是 | 商品状态 |
start_create_time | string | 否 | 开始创建时间 |
end_create_time | string | 否 | 结束创建时间 |
start_update_time | string | 否 | 开始更新时间 |
end_update_time | string | 否 | 结束更新时间 |
need_edit_spu | number | 否 | 默认0:获取线上数据, 1:获取草稿数据 |
page | number | 是 | 页号 |
page_size | number | 是 | 页面大小 |
回包参数说明
参数 | 类型 | 说明 |
---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
total_num | number | 总数 |
spus[] | object array | spu数组 |
spus[].product_id | number | 交易组件平台内部商品ID |
spus[].out_product_id | string | 商家自定义商品ID |
spus[].title | string | 标题 |
spus[].path | string | 绑定的小程序商品路径 |
spus[].head_img | string array | 主图,多张,列表 |
spus[].desc_info.desc | string | 商品详情图文 |
spus[].desc_info.imgs | string array | 商品详情图片 |
spus[].status | number | 商品线上状态 |
spus[].edit_status | number | 商品草稿状态 |
spus[].third_cat_id | number | 第三级类目ID |
spus[].brand_id | number | 品牌id |
spus[].create_time | string | 创建时间 |
spus[].update_time | string | 更新时间 |
spus[].skus[] | object array | sku数组 |
spus[].skus[].out_product_id | string | 商家自定义商品ID |
spus[].skus[].out_sku_id | string | 商家自定义skuID |
spus[].skus[].thumb_img | string | sku小图 |
spus[].skus[].sale_price | number | 售卖价格,以分为单位 |
spus[].skus[].market_price | number | 市场价格,以分为单位 |
spus[].skus[].stock_num | number | 库存 |
spus[].skus[].barcode | string | 条形码 |
spus[].skus[].sku_code | string | 商品编码 |
spus[].skus[].sku_attrs[].attr_key | string | 销售属性key(自定义) |
spus[].skus[].sku_attrs[].attr_value | string | 销售属性value(自定义) |
枚举-edit_status
枚举值 | 描述 |
---|
0 | 初始值 |
1 | 编辑中 |
2 | 审核中 |
3 | 审核失败 |
4 | 审核成功 |
枚举-status
枚举值 | 描述 |
---|
0 | 初始值 |
5 | 上架 |
9 | 逻辑删除 |
11 | 自主下架 |
12 | 售磬下架 |
13 | 违规下架/风控系统下架 |
返回码
返回码 | 错误类型 |
---|
-1 | 系统异常 |
-2 | token太长 |
9401020 | 参数有误 |
9401021 | 无权限调用该api |
9401002 | SPU不存在 |
9401001 | SPU已经存在 |
9401023 | SPU不允许编辑 |