API文档 >>   获取指定商户的团购信息

  • API名称:  获取指定商户的团购信息 deal/get_deals_by_business_id
  • 描述:根据城市和商户ID获取团购信息
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/deal/get_deals_by_business_id

请求参数

  • 必选参数

    名称 类型 说明
    appkey string App Key,应用的唯一标识
    sign string 请求签名,生成方式见《API请求签名生成文档》
    city string 包含团购信息的城市名称,可选范围见相关API返回结果
    business_id int 商户ID
  • 可选参数

    名称 类型 说明
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json

返回结果

  • 状态字段

    名称 类型 说明
    status string 本次API访问状态,如果成功返回"OK",并返回结果字段,如果失败返回"ERROR",并返回错误说明
    count int 本次API访问所获取的单页团购数量
  • 结果字段

    名称 类型 说明
    deal_id string 团购单ID
    title string 团购标题
    description string 团购描述
    city string 城市名称,city为"全国"表示全国单,其他为本地单,城市范围见相关API返回结果
    list_price float 团购包含商品原价值
    current_price float 团购价格
    regions list 团购适用商户所在商区
    categories list 团购所属分类
    purchase_count int 团购当前已购买数
    publish_date string 团购发布上线日期
    details string 团购详情
    purchase_deadline string 团购单的截止购买日期
    image_url string 团购图片链接,最大图片尺寸450×280
    s_image_url string 小尺寸团购图片链接,最大图片尺寸160×100
    more_image_urls list 更多大尺寸图片
    more_s_image_urls list 更多小尺寸图片
    is_popular int 是否为热门团购,0:不是,1:是
    restrictions list 团购限制条件
    restrictions.is_reservation_required int 是否需要预约,0:不是,1:是
    restrictions.is_refundable int 是否支持随时退款,0:不是,1:是
    restrictions.special_tips string 特别说明
    notice string 重要通知(一般为团购信息的临时变更)
    deal_url string 团购Web页面链接,适用于网页应用
    deal_h5_url string 团购HTML5页面链接,适用于移动应用和联网车载应用
    commission_ratio float 当前团单的佣金比例
    businesses list 团购所适用的商户列表
    businesses.name string 商户名
    businesses.id int 商户ID
    businesses.address string 商户地址
    businesses.latitude float 商户纬度
    businesses.longitude float 商户经度
    businesses.url string 商户页链接

注意事项

  • 如果传入的商户无在线的团购,返回空结果

API测试工具

示例请求

http://api.dianping.com/v1/deal/get_movie_deals_by_cinema?city=上海&business_id=1926046&appkey=[appkey]&sign=[signature]

示例结果

{ "status": "OK", "count": 3, "deals": [ { "deal_id": "1-219960", "title": "新世纪影城电影票", "description": "仅售39元,价值130元电影票1张!环境优雅舒适,大片云集,震撼视听双享受,带给你别样的精彩感受!", "city": "上海", "list_price": 130, "current_price": 39, "regions": [ "八佰伴" ], "categories": [ "电影" ], "purchase_count": 5349, "purchase_deadline": "2013-08-26", "publish_date": "2013-06-29", "details": "团购详情\n 凭大众点评网团购券可享受以下内容:\n\n- 电影票(1张,价值130元) \n", "image_url": "http://t2.dpfile.com/tuan/20130628/260329_130169072090000000.jpg", "s_image_url": "http://t3.dpfile.com/tuan/20130628/260329_130169072090000000_1.jpg", "more_image_urls": [], "more_s_image_urls": [], "is_popular": 0, "restrictions": { "is_reservation_required": 1, "is_refundable": 0, "special_tips": "特别提示\n \n有效期:2013-06-29 至 2013-08-31\n本团购券可使用商户详见页面右侧/手机客户端“查看适用商户” \n请客户直接去影院票房联影通兑换窗口,工作人员手持终端进行兑换。 \n凭本券可在有效期内兑换新世纪普通公映场次电影票1张\n本券兑换周五18:00之后(含18:00)场次电影需补贴人民币5元/张\n本券兑换周六,周日双休日所有场次电影需补贴人民币5元/张\n本券可兑换二日内电影票(8月31日仅可兑换当日电影票) \n本电子券VIP厅、首映式、国际电影节、影展等特殊场次除不可使用兑换电影。\n含3D,不含VIP厅、首映式、见面会等特殊场次 \n配备3D眼镜,需另缴纳押金 \n所有影片上映时间以影院为准 \n如遇特殊影片需补差价,补差规则详见影院公告 \n不可与其他优惠同享\n本单团购不支持退款\n \n" }, "notice": "", "deal_url": "http://cps.51ping.com/TLt2ub2j0l", "deal_h5_url": "http://cps.51ping.com/i3-1e1iNpv", "commission_ratio": 0.03, "businesses": [ { "name": "新世纪影城", "id": 1926046, "city": "上海", "address": "张杨路501号第一八佰伴10楼", "latitude": 31.226833, "longitude": 121.52274, "url": "http://cps.51ping.com/Wa8Pm0SroM", "h5_url": "http://cps.51ping.com/DiwGXp556X" } ] }}