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

一、使用场景

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

二、接口地址

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

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

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

参数 参数类型 是否必须 参数说明
appKey string yes 应用唯一标注
timestamp string yes 1970.1.1开始的毫秒数
pageSize Integer no 页码,每页返回的数据(默认20,上限不能超过50)
type string yes 商品分组名称,例如:分组1,分组2 (名称全匹配查询,不支持模糊查询);若需查询所有上架商品,请填写“全部”
pageNo Integer no 页数,默认第一页
sign string yes 签名(详见兑吧签名规则【签名规则】

四、响应参数

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

data明细表

参数 参数类型 参数说明
totalNum Integer 商品总条数
appItemId string 商品编码
bannerImage string 商品banner图片
credits long 积分
customTag string 商品标签
logo string 商品图标(logo)
marketPrice long 商品售价
multiImage string 商品详情图片
payload long 商品权重(无意义)
price long 商品结算费用
smallImage string 商品缩略图片
stock long 库存
title string 标题
type string 商品类型:object(实物),coupon(优惠券),virtual(虚拟商品)
url string 商品链接

五、响应示例

成功响应
{
  "success": "true",
  "data": {
    "totalNum": 100,
    "list": [
      {
       "totalNum":6,"list":[{"appItemId":2215360,
    "multiImage":null,
    "marketPrice":4600,
    "smallImage":"//yun.duiba.com.cn/images/202001/ddtzq1vkgh.png",
    "customTag":"全国包邮,#FF0000",
    "title":"《变形金刚》帽子",
    "type":"object",
    "url":"//activity.m.duiba.com.cn/mobile/appItemDetail?appItemId=2215360",
    "bannerImage":"",
    "credits":3600,
    "payload":19,
    "price":0,
    "logo":"",
    "stock":12
      },
      {
       "appItemId":2214327,
    "multiImage":null,
    "marketPrice":4900,
    "smallImage":"//yun.duiba.com.cn/images/201912/dypd5bvhcy.png",
    "customTag":"全国包邮,#FF0000",
    "title":"《变形金刚》手机壳及钥匙扣套装",
    "type":"object",
    "url":"//activity.m.duiba.com.cn/mobile/appItemDetail?appItemId=2214327",
    "bannerImage":"",
    "credits":3900,
    "payload":18,
    "price":0,
    "logo":"",
    "stock":137
      }
    ]
  }
}

失败响应:
{
    "success": false,
    "message": "请求已过期"
}

六.注意事项

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

results matching ""

    No results matching ""