轻易云
注册体验
POSThttps://dopen.weimob.com/api/1_0/weimob_shop/goods/getListaccess_token(accesstoken query 参数)

查询商品列表(weimob_shop/goods/getList)

微盟商城商品列表查询接口,分页拉取商品 ID、标题、价格、库存与状态,用于商品主数据对齐与跨系统建档;配套 goods/get 查详情。

来源：https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2396&id=3081&isold=2
## 接口说明 weimob_shop/goods/getList(v2.0)分页查询指定门店的商品列表,返回 goodsId、标题、价格、库存、在售状态等基础信息;配套接口 weimob_shop/goods/get 按 goodsId 查在售商品详情(名称、配送信息等),weimob_shop/goods/getListById 按 ID 批量查。 ### 请求要点 1. POST + application/json;accesstoken 拼 URL query。 2. body 参数:pageNum/pageSize 分页;可按门店(vid/组织)、商品状态、关键字等条件过滤(以接口文档为准)。 3. 响应 data.pageList 为商品数组,其中的 goodsId 是调用详情接口与库存/价格维护接口的入参;data.totalCount 用于翻页。 4. 商品主数据集成时,微盟商品需与 ERP 物料编码建立映射(建议用商家编码字段承载 ERP 编码),否则订单行无法自动匹配物料。 ### 典型链路 ERP 商品档案 → 轻易云映射清洗 → 微盟建档/更新;每日回拉商品列表比对(价格、库存、上下架状态差异),生成对齐报告。微盟作为私域商城前端时,库存来自 ERP/聚水潭的可售量下发,商品列表接口同时用于校验下发结果是否生效。 ### 多门店口径 微盟支持多门店(节点)商品体系,商品可能在总部与各门店分别维护;查询前要确认 vid 口径,总部视角与门店视角返回的商品集合不同,库存更是按门店隔离。集成设计时先画出组织树,再按节点确定同步范围与库存下发策略,避免把总部商品误铺到全部门店。

代码示例

curl
curl -X POST "https://dopen.weimob.com/api/1_0/weimob_shop/goods/getList?accesstoken=TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pageNum":1,"pageSize":50}'

错误码

错误码消息含义
0success成功
param_empty参数为空按错误提示补齐必传参数
api_not_granted无接口权限未申请商品 API 能力
查询商品列表(weimob_shop/goods/getList) | 轻易云