团购API使用说明


一、整体流程

您可以使用团购API构建自己的应用,将美团的团购数据展现给媒体用户,并为用户提供按城市、商圈、品类筛选团购套餐的团购查询功能,步骤如下(以美团团购查询为例):

步骤 调用接口 接口地址 获取结果
Step1 省份查询接⼝ https://www.jutuike.com/doc/27 全部省份信息
Step2 获取某个省份中城市信息 https://www.jutuike.com/doc/28 省份下的城市信息
Step3 获取某个城市类目信息 https://www.jutuike.com/doc/29 某个城市的类目信息
Step4 团单查询接口 https://www.jutuike.com/doc/31 团单信息


二、高级功能

1、增加商圈和用户LBS信息

通过【获取某个城市的商圈信息】(https://www.jutuike.com/doc/35)接口来获取当前城市的行政区与商圈信息来提升用户体验

2、增加二级类⽬

通过【获取某个城市的类目信息接口】(https://www.jutuike.com/doc/29)来获取当前城市一级类⽬下的⼆级类⽬信息

3、增加排序

通过使⽤【团单查询接口】(https://www.jutuike.com/doc/31)中的ApiDealSortType字段来增加排序功能

三、示例

http://p0.meituan.net/scarlett/6961f0c5eea8e0491753de09b8efbede581879.png

四、佣金比例

3%-5% 不同商家会有不同的佣金比例,最低3%

五、订单查询接口

https://www.jutuike.com/doc/17  类型是团单就是团购订单


六、基本字段说明

参数 类型 含义
dealBaseInfo ApiDealBaseInfoVO 团单基本信息
dealDetail ApiDealDetailVO 团单详情
shopInfo DealShopBaseInfoVO 商户信息
couponInfo ApiCouponInfoVO 优惠信息

ApiDealBaseInfoVO


参数 类型 含义
dealGroupId Integer 团单Id
dealTitle String 团单标题
dealDescription String 团单描述
defaultPic String 团单头图
realPrice Long 团单实际价格,单位分
finalPrice Long 券后价格,单位分
marketPrice Long 市场价格,单位分
dealType Integer 团单类型,返回code,code详情见DealType枚举


DealType

code 含义
1 套餐
2 代金券

ApiDealDetailVO

参数 类型 含义
halfYearSale Integer 半年销量
menuType Integer 菜单内容类型,返回code,code详情见ApiDealMenuType枚举信息
menu String 菜单

DealShopBaseInfoVO

参数 类型 含义
shopId Integer 门店Id
shopName String 门店名称
branchName String 分店名称,可能为空
brandName String 品牌名称,可能为空
cateName String 类目名
regionName String 商圈名
distance Long 距离,单位米,未传geo信息则为空
shopPower Long 星级,0-50,10为一星,45为四星
address String 门店地址
cityName String 门店城市名称

ApiCouponInfoVO

参数 类型 含义
discountPrice Long 满减金额,单位分
priceLimit Long 满减门槛,单位分
commissionRatio Double 分佣比例,两位小数
validStartDate String 抵用券开始时间
validEndDate String 抵用券结束时间
couponPageUrl String 领券页面跳转链接


微信咨询
请用微信扫码添加客服