商品列表查询接口(支持分组分页)
一、使用场景
开发者可以通过商品查询接口查询兑吧商品列表信息,查询到的商品信息在自己系统进行展示。接口可以查询的商品信息包含(商品标题,商品类型,详情页面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": [
{
"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分钟。
- 新的组件化后台商品查询,要通过该接口查询。