格物 开放 API商品

文档 · 通用规则

商品

商品接口正在重构为统一商品层:上线后所有场景用同一套商品接口、同一种商品 ID。在那之前按场景各用一组:

不提供不带条件就能翻完整个货盘的列表接口,找商品统一用搜索。

两组的入参、出参结构一致。下单时把商品接口返回的 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}'

本篇用到的接口