商品查询接口

优质
小牛编辑
125浏览
2023-12-01

一、使用场景

通过此接口可以查询兑吧后台已上架商品的信息,返回的商品信息包含商品标题、图片、商品链接、库存等,开发者可以将商品配置在积分商城外部投放,从而提高热门商品的曝光。

接口可以查询的商品类型包含普通兑换商品(优惠券、实物、虚拟商品、直冲类商品)、普兑商品对应的加钱购类型,以及活动类型(不含秒杀)。

注意:

  1. 本接口只支持全部商品查询,不支持分页和分组查询,如果要实现分组分页请参考【商品列表查询接口】
  2. 查询到的商品链接为内页链接,外部无法直接访问,需要通过免登录接口跳转。
  3. 接口查询的数据,并不是实时数据库的商品数据,而是查询缓存的数据,缓存时间为5分钟。

二、接口地址

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

接口支持http或https协议访问,响应内容中链接的协议头也会自适应转换。

三、请求参数

参数参数类型是否必须参数说明
appKeystringyes应用唯一标注
timestampstringyes1970.1.1开始的毫秒数
countIntegerno返回多少条商品信息(支持1--100条)
signstringyes签名参数,参见【签名规则

四、响应参数

参数参数类型参数说明
successtrue/false是否成功
messagestring一般为出错原因
datajson参见‘data明细表’

data明细表

参数参数类型是否必传参数说明
small_imagestringyes商品缩略图
logostringyes商品图标
banner_imagestringno商品banner图片
titlestringyes标题
appItemIdstringyes商品id
urlstringyes商品链接
cashlongyes积分加钱购付费金额(单位分),普通商品无此值
facePricelongyes商品面额,市场价格(单位分)
creditslongyes积分
remainStocklongno商品库存(默认不会传该参数,需要时要申请兑吧开通)

五、响应示例

{
  "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图片);