使用场景

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

接口地址(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 long 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:增加活动开始和结束时间()
2022-08-30:修改appItemId参数类型()

results matching ""

    No results matching ""