前置商品查询接口

一、使用场景

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

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

注意:

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

results matching ""

    No results matching ""