文档 · 通用规则
商品
商品接口正在重构为统一商品层:上线后所有场景用同一套商品接口、同一种商品 ID。在那之前按场景各用一组:
- 员工福利、企业采购:按关键词或类目
POST /v1/enterprise/products/search找商品(类目用GET /v1/enterprise/nav取),再用GET /v1/enterprise/products/{id}取详情与 SKU;首页专区、搜索联想可选。 - 消费者购物:按关键词
POST /v1/lm/products/search找商品,再用GET /v1/lm/products/{id}取详情与 SKU。
不提供不带条件就能翻完整个货盘的列表接口,找商品统一用搜索。
两组的入参、出参结构一致。下单时把商品接口返回的 id(以及 SKU 的 skuId)原样放进 items, 不要自己拼接或解析。
搜索、按类目浏览和翻页需要带 x-open-user;不带只能拿到第一页和精选位。
统一商品层上线时会提前通知,并给出新旧接口与商品 ID 的对照,旧接口保留一段过渡期。
1curl -X POST "https://api.gowu.net/v1/enterprise/products/search" \2 -H "x-app-key: $GOWU_APP_KEY" \3 -H "content-type: application/json" \4 -d '{"version":2,"query":{"text":"黑色 保温杯"},"mode":"strict","include":["match"],"limit":10}'