商品查询接口
优质
小牛编辑
130浏览
2023-12-01
一、使用场景
通过此接口可以查询兑吧后台已上架商品的信息,返回的商品信息包含商品标题、图片、商品链接、库存等,开发者可以将商品配置在积分商城外部投放,从而提高热门商品的曝光。
接口可以查询的商品类型包含普通兑换商品(优惠券、实物、虚拟商品、直冲类商品)、普兑商品对应的加钱购类型,以及活动类型(不含秒杀)。
注意:
- 本接口只支持全部商品查询,不支持分页和分组查询,如果要实现分组分页请参考【商品列表查询接口】
- 查询到的商品链接为内页链接,外部无法直接访问,需要通过免登录接口跳转。
- 接口查询的数据,并不是实时数据库的商品数据,而是查询缓存的数据,缓存时间为5分钟。
二、接口地址
https://activity.m.duiba.com.cn/queryForFrontItem/query?
接口支持http或https协议访问,响应内容中链接的协议头也会自适应转换。
三、请求参数
参数 | 参数类型 | 是否必须 | 参数说明 |
---|---|---|---|
appKey | string | yes | 应用唯一标注 |
timestamp | string | yes | 1970.1.1开始的毫秒数 |
count | Integer | no | 返回多少条商品信息(支持1--100条) |
sign | string | yes | 签名参数,参见【签名规则】 |
四、响应参数
参数 | 参数类型 | 参数说明 |
---|---|---|
success | true/false | 是否成功 |
message | string | 一般为出错原因 |
data | json | 参见‘data明细表’ |
data明细表
参数 | 参数类型 | 是否必传 | 参数说明 |
---|---|---|---|
small_image | string | yes | 商品缩略图 |
logo | string | yes | 商品图标 |
banner_image | string | no | 商品banner图片 |
title | string | yes | 标题 |
appItemId | string | yes | 商品id |
url | string | yes | 商品链接 |
cash | long | yes | 积分加钱购付费金额(单位分),普通商品无此值 |
facePrice | long | yes | 商品面额,市场价格(单位分) |
credits | long | yes | 积分 |
remainStock | long | no | 商品库存(默认不会传该参数,需要时要申请兑吧开通) |
五、响应示例
{
"success": "true",
"data": [
{
"title": "商品1",
"url": "http://goods.m.duiba.com.cn/mobile/detail?id=1",
"small_image": "http://yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
"logo":"http://yun.duiba.com.cn/images/201804/logo1.jpg",
"banner_image":"http://yun.duiba.com.cn/images/201804/bannerimage1.jpg",
"appItemId": "1984670",
"credits": 100,
"cash": 500,
"facePrice": 2000,
"remainStock":100
},
{
"title": "商品2",
"url": "http://goods.m.duiba.com.cn/mobile/detail?id=1",
"small_image": "http://yun.duiba.com.cn/images/201801/ymhybfbytk.jpg",
"logo":"http://yun.duiba.com.cn/images/201804/logo1.jpg",
"banner_image":"http://yun.duiba.com.cn/images/201804/bannerimage1.jpg",
"appItemId": "1984670",
"credits": 200,
"cash": 1000,
"facePrice": 3000,
"remainStock":1002
}
]
}
更新记录:
2018-07-12:增加商品appItemId字段。
2018-07-27: 新增加现金(积分加钱购),商品市场价值字段
2018-10-25:新增字段logo(商品图标图片), banner_image(商品banner图片);