# 商品信息查询
接口规范:
要求 | 备注 |
---|---|
http-post格式 | |
通知类接口需要支持重试 |
# 1 分页查询商品信息
# 1.1 分页查询商品信息
# 接口说明:
- 接口由宜信提供,合作方调用。
- 签名工具类会在对接时提供
- content-type: application/json
# 接口地址:
/mall/openApi/product/queryProductList
# 请求参数:
字段名 | 字段类型 | 备注 |
---|---|---|
sign | String | 签名结果(签名工具类对接时提供) |
secondCategory | String | 商品三级分类code |
pageNum | Integer | 查询的页码数 |
pageSize | Integer | 查询的条数 |
# 响应参数:
字段名 | 字段类型 | 备注 |
---|---|---|
status | String | 返回状态码 1:成功状态 0:失败 1001:参数校验失败 1005: 签名验证失败 1006:重复提交 1009:请求的时间戳_t超过30分钟 |
message | String | 返回提示 |
data | List<Object> | 返回数据体 |
# data返回数据
字段名 | 字段类型 | 备注 |
---|---|---|
sku | String | 商品编号 |
spu | String | 商品spu |
productName | String | 商品名称 |
productTitle | String | 商品副标题 |
brandName | String | 商品品牌名称 |
brandNameEN | String | 商品品牌英文名 |
secondCategory | String | 三级分类code |
secondCategoryType | String | 三级分类名 |
mainImagePath | List<String> | 商品页主图列表 |
detailInfo | List<String> | 商品详情图 |
skuImage | String | sku主图 |
productAttr | List<NameValuePair> | 商品属性列表 |
suggestedPrice | String | 建议售价 |
agreementPrice | String | 协议价 |
isSupportRefund | Integer | 是否支持退货:0不支持,1支持 |
skuList | List<String> | 同spu下的sku列表 |
status | Integer | 商品上下架状态:0:下线,1:上线 |
specificationList | List<NameValuePair> | 参数规格 |
packingList | String | 包装清单 |
# 2. 商品信息变更推送
# 接口说明:
- 此接口需要由合作方实现, 并提供地址给宜信
- 签名工具类会在对接时提供
- content-type: application/json
# 接口地址:
由合作方提供 在商品发生协议价、上下架状态发生改变时,会调用该接口推送通知 请求参数为宜信方调用合作方接口传递的参数
# 请求参数:
字段名 | 字段类型 | 备注 |
---|---|---|
sign | String | 签名结果(签名工具类对接时提供) |
type | Integer | 通知类型 0-协议价变更 1-上下架状态变化 |
spu | String | 商品spu |
sku | String | 商品sku |
agreementPrice | BigDecimal | 变更后协议价 (type=0时非空) |
status | Integer | 变更后状态 (type=1时非空) |
time | Date | 通知时间 |
serialNum | String | 通知唯一序列号 |
# 响应参数:
字段名 | 字段类型 | 备注 |
---|---|---|
result | String | 返回ok认为成功 |