秒杀活动查询接口

优质

小牛编辑

115浏览

2023-12-01

积分商城营销工具中的营销商品包的秒杀活动，在使用场景中有对接开发者需要通过接口查询对应的秒杀活动数据在自己页面中展示，针对此类场景，兑吧开放了秒杀活动前置查询接口。接口查询数据内容是下图中的数据。

接口地址(GET 请求)

https://activity.m.duiba.com.cn/chw/seckill/api/queryList

请求参数（get请求）

参数	是否必须	类型	说明
appKey	yes	string	应用唯一标注
timestamp	yes	string	当前时间毫秒值
sign	yes	string	签名参数，参见【签名规则】

响应参数

参数	参数类型	参数说明
code	string	状态码
success	true/false	是否成功
message	string	一般为出错原因
data	json	参见‘data明细表’

data明细表

参数	参数类型	是否必传	参数说明
appItemId	Integer	yes	商品ID
multiImage	string	yes	商品主图，多个由","间隔
sellingPoint	string	no	商品卖点描述
link	string	yes	秒杀活动链接
title	string	yes	活动标题
itemSmallImage	string	yes	活动列表图
secCredits	string	yes	秒杀所需积分
facePrice	string	yes	商品市面价值，单位元，2位小数
secPrice	string	yes	积分加钱购金额，单位元，2位小数
totalStock	Integer	yes	剩余总库存
startTimestamp	long	yes	当日秒杀开始时间戳
endTimestamp	long	yes	当日秒杀结束时间戳
firstStartTimestamp	long	yes	秒杀活动开始时间戳
lastEndTimestamp	long	yes	秒杀活动结束时间戳
currentSecCount	Integer	yes	当前期次已秒杀数量
currentSecLimit	Integer	yes	当前期次可以秒杀总限制数量
runStatus	Integer	yes	活动状态： 0未开始， 10进行中， 11进行中且库存不足， 12进行中且秒杀库存不足， 20已结束

响应示例

    {
    "data": [{
    "appItemId": 1717297,
    "firstStartTimestamp": 1566454500000,
    "multiImage": "//yun.dui88.com/images/201904/gf5mgwgqy6.jpg",
    "lastEndTimestamp": 1566489600000,
    "link": "//activity.m.duibadev.com.cn/seckw/v2/detail?actId=28",
    "sellingPoint": null,
    "title": "test222",
    "itemSmallImage": "//yun.dui88.com/images/201904/u0uerf8q2l.jpg",
    "secPrice": "0.00",
    "secCredits": "11",
    "facePrice": "1.00",
    "totalStock": 1,
    "endTimestamp": 1557936000000,
    "currentSecCount":133,
    "currentSecLimit":1000,
    "runStatus": 20,
    "startTimestamp": 1557849600000
    }, {
    "appItemId": 1717322,
    "firstStartTimestamp": 1566454500000,
    "multiImage": "//yun.dui88.com/images/201905/uthnep5gt1.png",
    "lastEndTimestamp": 1566489600000,
    "link": "//activity.m.duibadev.com.cn/seckw/v2/detail?actId=27",
    "sellingPoint": null,
    "title": "test22222",
    "itemSmallImage": "//yun.dui88.com/images/201905/uthnep5gt1.png",
    "secPrice": "0.00",
    "secCredits": "1000",
    "facePrice": "1232.00",
    "totalStock": 1,
    "endTimestamp": 1557849600000,
    "currentSecCount":12,
    "currentSecLimit":100,
    "runStatus": 20,
    "startTimestamp": 1557763200000
    }, {
    "appItemId": 1717310,
    "firstStartTimestamp": 1566454500000,
    "multiImage": "//yun.dui88.com/images/201905/0og2zay5wn.png,//yun.dui88.com/images/201905/mhx2qd5p47.png",
    "lastEndTimestamp": 1566489600000,
    "link": "//activity.m.duibadev.com.cn/seckw/v2/detail?actId=26",
    "sellingPoint": "卖点描述文案",
    "title": "sunyan1",
    "itemSmallImage": "//yun.dui88.com/images/201905/5hrq0d4622.png",
    "secPrice": "0.01",
    "secCredits": "0",
    "facePrice": "215.00",
    "totalStock": 23,
    "endTimestamp": 1558713600000,
    "currentSecCount":3,
    "currentSecLimit":10,
    "runStatus": 20,
    "startTimestamp": 1558627200000
    }],
    "success": true,
    "message": "查询成功"
    }

接口修改日志：

2019-08-21：增加活动开始和结束时间（）