商品列表查询接口(支持分类)

一、使用场景

开发者可以通过商品查询接口查询兑吧商品列表信息,查询到的商品信息在自己系统进行展示。接口可以查询的商品信息包含(商品标题,商品类型,详情页面url,商品缩略图,商品banner图,积分价格,积分加钱的人民币的值,商品真实价值),接口支持查询商品类型包含实物,优惠券和虚拟商品三种。

二、接口地址

https://activity.m.duiba.com.cn/queryForFrontItem/querypage?

接口支持http和https两种请求方式访问。

三、请求参数(Get方式请求)

参数 参数类型 参数说明
appKey string 应用唯一标注
timestamp string 1970.1.1开始的毫秒数
pageSize int 页码,每页返回的数据(默认20,上限不能超过50)
type string 商品分组名称,例如:分组1,分组2 (名称全匹配查询,不支持模糊查询)
pageNo int 页数,默认第一页
sign string 签名(详见兑吧签名规则【签名规则】

四、响应参数

参数 参数类型 参数说明
success true/false 是否成功
message string 一般为出错原因
data json 参见‘data明细表’

data明细表

参数 参数类型 参数说明
totalNum int 商品总条数
title string 标题
url string 商品链接
type string 商品类型:object(实物),coupon(优惠券),virtual(虚拟商品)
logo string 商品图标(logo)
smallImage string 商品缩略图片
bannerImage string 商品banner图片
credits long 积分
stock long 库存
price long 商品市场价值(单位分)

五、响应示例

{
  "success": "true",
  "message": "",
  "data": {
    "totalNum": 100,
    "list": [
      {
        "title": "商品1",
        "url": "goods.m.duiba.com.cn/mobile/detail?id=1",
        "type": "object",
        "smallImage": "//yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
        "bannerImage": "//yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
        "logo": "//yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
        "credits": 100,
        "stock" :20,
        "price": 100,
        "marketPrice": 200
      },
      {
        "title": "商品2",
        "url": "goods.m.duiba.com.cn/mobile/detail?id=2",
        "type": "object",
        "smallImage": "//yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
        "bannerImage": "//yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
         "logo": "//yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
        "credits": 100,
        "stock" :100,
        "price": 200,
        "marketPrice": 300
      }
    ]
  }
}

六.注意事项

  1. 商品列表查询的数据,并不是实时数据库的商品数据,而是查询缓存的数据,缓存时间是5分钟
  2. 新的组件化后台商品查询,要通过该接口查询。

results matching ""

    No results matching ""