商品列表查询接口
优质
小牛编辑
129浏览
2023-12-01
一、使用场景
开发者可以通过商品查询接口查询兑吧商品列表信息，查询到的商品信息在自己系统进行展示。接口可以查询的商品信息包含（商品标题，商品类型，详情页面url，商品缩略图，商品banner图，积分价格，积分加钱的人民币的值，商品真实价值），接口支持查询商品类型包含实物，优惠券和虚拟商品三种。
二、接口地址
https://activity.m.duiba.com.cn/queryForFrontItem/querypage?
接口支持http和https两种请求方式访问。
三、请求参数(Get方式请求)
| 参数 | 参数类型 | 参数说明 |
|---|---|---|
| appKey | string | 应用唯一标注 |
| timestamp | string | 1970.1.1开始的毫秒数 |
| pageSize | Integer | 页码，每页返回的数据（默认20，上限不能超过50） |
| type | string | 商品分组名称，例如：分组1，分组2 （名称全匹配查询，不支持模糊查询） |
| pageNo | Integer | 页数，默认第一页 |
| sign | string | 签名（详见兑吧签名规则【签名规则】） |
四、响应参数
| 参数 | 参数类型 | 参数说明 |
|---|---|---|
| success | true/false | 是否成功 |
| message | string | 一般为出错原因 |
| data | json | 参见‘data明细表’ |
data明细表
| 参数 | 参数类型 | 参数说明 |
|---|---|---|
| totalNum | Integer | 商品总条数 |
| appItemId | string | 商品编码 |
| bannerImage | string | 商品banner图片 |
| credits | long | 积分 |
| customTag | string | 商品标签 |
| logo | string | 商品图标（logo） |
| marketPrice | string | 商品售价 |
| 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": "请求已过期"
}
六.注意事项
- 商品列表查询的数据，并不是实时数据库的商品数据，而是查询缓存的数据，缓存时间是5分钟。
- 新的组件化后台商品查询，要通过该接口查询。