获取商品列表

接口调用请求说明

时间范围 create_timeupdate_time 同时存在时,以 create_time 的范围为准

  1. http请求方式:POST
  2. https://api.weixin.qq.com/shop/spu/get_list?access_token=xxxxxxxxx

请求参数示例

  1. {
  2. "status": 5, // 选填,不填时获取所有状态商品
  3. "start_create_time": "2020-12-25 00:00:00", // 选填,与end_create_time成对
  4. "end_create_time": "2020-12-26 00:00:00", // 选填,与start_create_time成对
  5. "start_update_time": "2020-12-25 00:00:00", // 选填,与end_update_time成对
  6. "end_update_time": "2020-12-26 00:00:00", // 选填,与start_update_time成对
  7. "page": 1,
  8. "page_size": 10, // 不超过100
  9. "need_edit_spu": 1 // 默认0:获取线上数据, 1:获取草稿数据
  10. }

回包示例

  1. {
  2. "errcode": 0,
  3. "errmsg":"ok",
  4. "total_num": 20,
  5. "spus":
  6. [
  7. {
  8. "out_product_id": "1234566",
  9. "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
  10. "path": "pages/productDetail/productDetail?productId=2176180",
  11. "head_img":
  12. [
  13. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  14. ],
  15. "desc_info":
  16. {
  17. "desc": "xxxxx",
  18. "imgs":
  19. [
  20. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  21. ]
  22. },
  23. "third_cat_id": 6666,
  24. "brand_id": 2100000000,
  25. "create_time": "2020-12-25 00:00:00",
  26. "update_time": "2020-12-26 00:00:00",
  27. "skus":
  28. [
  29. {
  30. "out_product_id": "1234566",
  31. "out_sku_id": "1024",
  32. "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
  33. "sale_price": 1300,
  34. "market_price": 1500,
  35. "stock_num": 100,
  36. "sku_code": "A24525252",
  37. "barcode": "13251454",
  38. "sku_attrs":
  39. [
  40. {
  41. "attr_key": "选择颜色",
  42. "attr_value": "红蓝主机"
  43. },
  44. {
  45. "attr_key": "选择套装",
  46. "attr_value": "主机+保护套"
  47. }
  48. ]
  49. }
  50. ]
  51. },
  52. ...
  53. ]
  54. }

请求参数说明

参数类型是否必填说明
statusnumber商品状态
start_create_timestring开始创建时间
end_create_timestring结束创建时间
start_update_timestring开始更新时间
end_update_timestring结束更新时间
need_edit_spunumber默认0:获取线上数据, 1:获取草稿数据
pagenumber页号
page_sizenumber页面大小

回包参数说明

参数类型说明
errcodenumber错误码
errmsgstring错误信息
total_numnumber总数
spus[]object arrayspu数组
spus[].product_idnumber交易组件平台内部商品ID
spus[].out_product_idstring商家自定义商品ID
spus[].titlestring标题
spus[].pathstring绑定的小程序商品路径
spus[].head_imgstring array主图,多张,列表
spus[].desc_info.descstring商品详情图文
spus[].desc_info.imgsstring array商品详情图片
spus[].statusnumber商品线上状态
spus[].edit_statusnumber商品草稿状态
spus[].third_cat_idnumber第三级类目ID
spus[].brand_idnumber品牌id
spus[].create_timestring创建时间
spus[].update_timestring更新时间
spus[].skus[]object arraysku数组
spus[].skus[].out_product_idstring商家自定义商品ID
spus[].skus[].out_sku_idstring商家自定义skuID
spus[].skus[].thumb_imgstringsku小图
spus[].skus[].sale_pricenumber售卖价格,以分为单位
spus[].skus[].market_pricenumber市场价格,以分为单位
spus[].skus[].stock_numnumber库存
spus[].skus[].barcodestring条形码
spus[].skus[].sku_codestring商品编码
spus[].skus[].sku_attrs[].attr_keystring销售属性key(自定义)
spus[].skus[].sku_attrs[].attr_valuestring销售属性value(自定义)

枚举-edit_status

枚举值描述
0初始值
1编辑中
2审核中
3审核失败
4审核成功

枚举-status

枚举值描述
0初始值
5上架
9逻辑删除
11自主下架
12售磬下架
13违规下架/风控系统下架

返回码

返回码错误类型
-1系统异常
-2token太长
9401020参数有误
9401021无权限调用该api
9401002SPU不存在
9401001SPU已经存在
9401023SPU不允许编辑