Qeasy Cloud
Get Started
POSThttps://dopen.weimob.com/api/1_0/weimob_shop/goods/getListaccess_token(accesstoken query 参数)

Query Goods List (weimob_shop/goods/getList)

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

## Overview weimob_shop/goods/getList (v2.0) pages through the goods of a given store, returning goodsId, title, price, stock and sale status; companions include weimob_shop/goods/get (full on-sale detail by goodsId) and weimob_shop/goods/getListById (batch by IDs). ### Request essentials 1. POST with Content-Type: application/json; accesstoken rides in the URL query. 2. Body: pageNum/pageSize, plus filters by store (vid/organization), goods status or keyword per the docs. 3. data.pageList carries the goods; goodsId is the input for detail and stock/price maintenance APIs, and data.totalCount drives pagination. 4. For product master integration, map Weimob goods to ERP material codes (best carried in the merchant-code field) — otherwise order lines cannot auto-match materials. ### Typical pipeline ERP item master → Qeasy mapping/cleansing → Weimob create/update; a daily pull compares price, stock and on-shelf status and emits an alignment report. When Weimob serves as the private-domain storefront, stock arrives from ERP/Jushuitan sellable pushes, and this list API verifies the pushes actually took effect. ### Multi-store semantics Weimob supports multi-store (node) catalogs where goods may be maintained at headquarters and per store. Confirm the vid scope before querying: the HQ view and store views return different goods sets, and stock is store-isolated. Draw the organization tree first, then decide the sync scope and stock-distribution policy per node, instead of accidentally rolling HQ goods out to every store.

Code examples

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}'

Error codes

CodeMessageMeaning
0success成功
param_empty参数为空按错误提示补齐必传参数
api_not_granted无接口权限未申请商品 API 能力