文档
测试

限时秒杀首页展示

websocket测试
POST
/union/v2/homeSeckill

接口描述

查询限时秒杀首页信息（使用前需要先绑定手机号）

请求头

参数名
类型
描述
必填
ACCESSTOKEN
string
登录注册时返回的用户ppId
必填

请求参数

参数名
类型
描述
必填
cityId
string
城市id 城市id取附近优惠枚举中的值 不同于天气中的城市id
必填
lat
string
纬度
必填
lon
string
经度
必填

响应参数

参数名
类型
描述
必填
code
int
返回结果码 1000-成功 非1000-未成功
必填
data
object
返回结果对象
必填
endTime
long
结束时间 毫秒
必填
goodsList
array
展示的前十条数据
必填
apiCouponInfoVo
object
抵用券信息
必填
commissionRatio
float
佣金比例
必填
discountPrice
int
抵用券金额
必填
priceLimit
int
抵用券满减门槛
必填
validEndDate
string
抵用券有效期结束时间
必填
validStartDate
string
抵用券有效期开始时间
必填
seckillShopDealInfoVo
object
秒杀商户团单信息
必填
address
string
地址
必填
avgScore
float
评分
必填
bareaName
string
门店所处商圈
必填
cateName
string
品类信息(二级类目)
必填
dealList
array
数据列表
必填
availableTime
string
deal可用时间 比如：周一至周五可用
必填
campaignConsume
int
当前场次秒杀已卖数量
必填
campaignStock
int
秒杀总库存
必填
couponPageUrl
string
领券页地址
必填
dealId
int
dealId,分双侧
必填
disCount
string
折扣
必填
finalPrice
int
秒杀价,单位分
必填
imgUrl
string
deal图片
必填
isNewCustomer
boolean
该商户是否设置新客专享秒杀
必填
marketPrice
int
市场价,单位分
必填
menu
array
套餐内容
必填
seckillStatus
int
秒杀状态 0-未开抢,该状态表示秒杀还未开始且距离秒杀开始超过5分钟；1-马上抢,表示秒杀已经开始，且秒杀deal库存大于0；2-已抢光,表示秒杀库存没有了,或者用户已经抢过该团单；3-仅限新客,该秒杀deal仅限门店新客使用，但是请求用户非门店新客；4-已结束,表示秒杀已经结束；5-即将开抢,表示离秒杀开始五分钟内
必填
soldPercent
int
售卖进度
必填
title
string
deal标题
必填
distance
int
商户到用户距离 单位m
必填
shopId
int
门店Id（将要废弃-不再使用）
必填
shopName
string
门店名称
必填
shopUuid
string
商户uuid，使用方式与shopId一致-建议使用
必填
showId
int
秒杀场次id
必填
startTime
long
开始时间 毫秒
必填
message
string
返回结果信息
必填

说明 / 示例

{ "code": 1000, "data": { "endTime": 1627966800000, "goodsList": [ { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "江浦路1082号（近周家嘴路）", "avgScore": 4.3, "bareaName": "控江地区", "cateName": "零食", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 325, "campaignStock": 17240, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=677150599&shopId=175725928&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 677150599, "disCount": "2.6", "finalPrice": 100, "imgUrl": "https://p0.meituan.net/320.0/deal/7ed1fd5e10b0f4f0c8d4f789d6d1a0ea28180.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 390, "menu": [ "19291 QQ冻可吸果冻（原味）" ], "seckillStatus": 1, "soldPercent": 18, "title": "19291 QQ冻可吸果冻（原味）1份" } ], "distance": 358, "shopId": 175725928, "shopName": "来伊份（江浦路二店）", "shopUuid": "175725928" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "江浦路1082号（近周家嘴路）", "avgScore": 4.3, "bareaName": "控江地区", "cateName": "零食", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 487, "campaignStock": 17216, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=713565837&shopId=175725928&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 713565837, "disCount": "1.7", "finalPrice": 100, "imgUrl": "https://p0.meituan.net/320.0/deal/3c1b3abe92bf725f229c0d9c8ba55790141676.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 590, "menu": [ "20893吸吸龟苓膏（冰糖菊花味）253g" ], "seckillStatus": 1, "soldPercent": 15, "title": "20893吸吸龟苓膏（冰糖菊花味）253g1份" } ], "distance": 358, "shopId": 175725928, "shopName": "来伊份（江浦路二店）", "shopUuid": "175725928" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "江浦路1082号（近周家嘴路）", "avgScore": 4.3, "bareaName": "控江地区", "cateName": "零食", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 307, "campaignStock": 17240, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=677154508&shopId=175725928&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 677154508, "disCount": "2.5", "finalPrice": 100, "imgUrl": "https://p1.meituan.net/320.0/deal/534ca9b2cceb36f9d42822048d7fe2b133388.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 399, "menu": [ "19278 QQ冻可吸果冻（可乐味）" ], "seckillStatus": 1, "soldPercent": 18, "title": "19278 QQ冻可吸果冻（可乐味）1份" } ], "distance": 358, "shopId": 175725928, "shopName": "来伊份（江浦路二店）", "shopUuid": "175725928" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "长阳路1687号长阳创谷B幢独角兽花园大街15号(长阳会堂隔壁)", "avgScore": 4.8, "bareaName": "平凉路/东外滩", "cateName": "奶茶/果汁", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 2, "campaignStock": 15, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=710456376&shopId=186569286&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 710456376, "disCount": "1.0", "finalPrice": 100, "imgUrl": "https://p0.meituan.net/320.0/deal/637da016e5a0c5fe0e25bb73ffbfc99e781197.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": true, "marketPrice": 1000, "menu": [ "小粉羊冰淇淋" ], "seckillStatus": 1, "soldPercent": 27, "title": "小粉羊冰淇淋1个" } ], "distance": 1017, "shopId": 186569286, "shopName": "点叶·羊乳奶茶（长阳创谷店）", "shopUuid": "186569286" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "控江路1628号紫荆广场B1F-15", "avgScore": 4.5, "bareaName": "控江地区", "cateName": "奶茶/果汁", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 116, "campaignStock": 800, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=711377863&shopId=193748481&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 711377863, "disCount": "6.7", "finalPrice": 1463, "imgUrl": "https://p0.meituan.net/320.0/deal/b5df023405320d60f3a564322c454aac152345.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 2200, "menu": [ "超级奥利奥冰" ], "seckillStatus": 1, "soldPercent": 28, "title": "超级奥利奥冰1份" } ], "distance": 718, "shopId": 193748481, "shopName": "7分甜（杨浦紫荆广场店）", "shopUuid": "193748481" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "控江路1628号L110-L111A铺", "avgScore": 4.2, "bareaName": "控江地区", "cateName": "港台甜品", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 41, "campaignStock": 400, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=713958116&shopId=80777435&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 713958116, "disCount": "5.3", "finalPrice": 1490, "imgUrl": "https://p0.meituan.net/320.0/deal/8b9f6ed08ec4fc5753eba56a6bbe27c09417.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 2800, "menu": [ "胭脂红豆双皮奶" ], "seckillStatus": 1, "soldPercent": 28, "title": "胭脂红豆双皮奶1杯" } ], "distance": 677, "shopId": 80777435, "shopName": "满记甜品（紫荆广场店）", "shopUuid": "80777435" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "长阳路1689号（华晶宾馆旁）", "avgScore": 4.3, "bareaName": "平凉路/东外滩", "cateName": "炸鸡炸串", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 26, "campaignStock": 2860, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=711684527&shopId=165439120&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 711684527, "disCount": "5.0", "finalPrice": 990, "imgUrl": "https://p0.meituan.net/320.0/deal/dbd03467fe6ba3113b783908d109b09a41853.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 2000, "menu": [ "脆皮鸡排" ], "seckillStatus": 1, "soldPercent": 20, "title": "脆皮鸡排1份" } ], "distance": 1297, "shopId": 165439120, "shopName": "正新鸡排·炸鸡烧烤（长阳路店）", "shopUuid": "165439120" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "控江路1720号底层-8临（近鞍山路）", "avgScore": 4.5, "bareaName": "控江地区", "cateName": "熟食熏酱", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 225, "campaignStock": 16768, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=704853122&shopId=414255&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 704853122, "disCount": "5.5", "finalPrice": 550, "imgUrl": "https://p0.meituan.net/320.0/deal/5b79f154856c19d47b0adb22568fa07d379731.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 1000, "menu": [ "素菜任选" ], "seckillStatus": 1, "soldPercent": 21, "title": "素菜任选1份" } ], "distance": 898, "shopId": 414255, "shopName": "紫燕百味鸡（控江店）", "shopUuid": "414255" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "控江路2066号1号楼B1层B1-09", "avgScore": 3.9, "bareaName": "控江地区", "cateName": "卤味鸭脖", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 13, "campaignStock": 4456, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=714995587&shopId=163083381&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 714995587, "disCount": "3.3", "finalPrice": 100, "imgUrl": "https://p0.meituan.net/320.0/deal/b9408b6963c0d9ec3b2eaab2f4ea687f38606.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 300, "menu": [ "代金券" ], "seckillStatus": 1, "soldPercent": 16, "title": "3元代金券1张" } ], "distance": 1328, "shopId": 163083381, "shopName": "留夫鸭（控江路旭辉店）", "shopUuid": "163083381" } }, { "apiCouponInfoVo": { "commissionRatio": 0.03, "discountPrice": 100, "priceLimit": 500, "validEndDate": "2021-08-09", "validStartDate": "2021-08-03" }, "seckillShopDealInfoVo": { "address": "控江路1720号底层-8临（近鞍山路）", "avgScore": 4.5, "bareaName": "控江地区", "cateName": "熟食熏酱", "dealList": [ { "availableTime": "周一至周日可用", "campaignConsume": 41, "campaignStock": 16768, "couponPageUrl": "https://act.meituan.com/clover/page/adunioncps/api_coupon?utmSource=71275&utmMedium=3411A53F37814DC34D5398D88B7604DEACF0EE50FB1A48380F81C45065F38AB69F0BD423B724D78FFDFEB540EBD4E979&dealGroupId=700963257&shopId=414255&platformId=2&activity=OBh9oXJ9lF&promotionId=30146&userLevel=1.0&serverTrackId=4962285691049824534&&sessionUuid=07f90b30-2382-41c7-8f52-5c9528276572", "dealId": 700963257, "disCount": "5.5", "finalPrice": 550, "imgUrl": "https://p0.meituan.net/320.0/deal/176b77e3d5f593796ca6a6cffdd331ba1597264.jpg%40320w_240h_1e_1c_1l%7Cwatermark%3D0", "isNewCustomer": false, "marketPrice": 1000, "menu": [ "海带丝", "云丝" ], "seckillStatus": 1, "soldPercent": 13, "title": "海带丝/云丝2选1" } ], "distance": 898, "shopId": 414255, "shopName": "紫燕百味鸡（控江店）", "shopUuid": "414255" } } ], "showId": 1, "startTime": 1627959600000 }, "message": "调用成功" }
上一篇 查询附近优惠商品列表
nextDoc 限时秒杀详情查询
本文档使用易文档编写, 更新时间: 2021-08-03 15:28