接口描述:

  • 根据商品分类获取指定类型的商品(推荐,热卖,新品,积分,同品牌,同价位)。

请求 URL:

  • http|https://host/api/v1/goods/method/get.goods.index.type/

请求方式:

  • GET
  • POST

是否授权:

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
goods_category_id integer gt:0 1 商品分类编号
goods_type integer 见附属 A hot 商品类型
brand_id integer egt:0 1 商品品牌编号
shop_price array length:2 [50,100] 商品价格区间
page_no integer gt:0 1 1 页码
page_size integer between:1,40 15 15 每页数量

附属 A:
in:integral,recommend,new,hot


integral = 积分可抵扣商品
recommend = 推荐商品
new = 新品
hot = 热卖商品

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 4 合计计数
items 类型 是否返回 示例值 描述
goods_id integer 5 商品编号
name string MateBook 商品名称
short_name string MateBook 商品短名称
sales_sum integer 0 销售数量
is_postage integer 1 是否包邮 0=收费 1=包邮
market_price number 7000 商品市场价
shop_price number 5400 商品本店价
attachment array ["//image_1.jpg"] 商品相册

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "goods_id": 13,
  8. "name": "MateBook",
  9. "short_name": "MateBook",
  10. "sales_sum": 0,
  11. "is_postage": 1,
  12. "market_price": 7000,
  13. "shop_price": 5400,
  14. "attachment": [
  15. "//image_1.jpg"
  16. ]
  17. },
  18. {
  19. "goods_id": 4,
  20. "name": "不带规格的商品",
  21. "short_name": "",
  22. "sales_sum": 0,
  23. "is_postage": 1,
  24. "market_price": 500,
  25. "shop_price": 300,
  26. "attachment": [
  27. "//image.jpg"
  28. ]
  29. }
  30. ],
  31. "total_result": 2
  32. }
  33. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。
文档更新时间: 2018-06-21 23:45