API文档 >>   批量获取指定团购信息

  • API名称:  批量获取指定团购信息 deal/get_batch_deals_by_id
  • 描述:根据多个团购ID批量获取指定团购单的详细信息
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/deal/get_batch_deals_by_id

请求参数

  • 必选参数

    名称 类型 说明
    deal_ids string 一个或多个团购ID集合,多ID之间以英文逗号分隔,如“1-120239,1-121039,1-87299”,一次传入的ID数量上限为40个,其他参数限制请参考下方注意事项
    appkey string App Key,应用的唯一标识
    sign string 请求签名,生成方式见《API请求签名生成文档》
  • 可选参数

    名称 类型 说明
    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 商户页链接

注意事项

  • 本接口尚处于测试阶段,参数deal_ids仅支持传入同一城市的团购ID集合,如果同时混合传入不同城市的团购ID,结果只返回与参数字符串中第一个团购属于同一城市的团购信息,不同城市的团购ID会被自动忽略
  • 如果传入的团购ID对应的团购已经下线,该团购ID会被自动忽略

API测试工具

示例请求

http://api.dianping.com/v1/deal/get_batch_deals_by_id?deal_ids=1-121039,1-5097286&appkey=[appkey]&sign=[signature]

示例结果

{
  "status": "OK",
  "count": 1,
  "deals": [
    {
      "deal_id": "1-5097286",
      "title": "Le Camelia法式浪漫拿破仑",
      "description": "仅售138元,价值238元法式浪漫拿破仑1个!2店通用!月星环球港新店开业!法式甜品经典,三十多层香脆起酥皮,融合清新奶油,口感层次丰富,幸福甜蜜妙不可言!",
      "city": "上海",
      "list_price": 238,
      "current_price": 138,
      "regions": [
        "世纪公园",
        "月星环球港"
      ],
      "categories": [
        "面包甜点"
      ],
      "purchase_count": 241,
      "purchase_deadline": "2014-01-23",
      "publish_date": "2013-10-24",
      "details": "团购详情\n 凭大众点评网团购券可享受以下内容:\n\n- 法式浪漫拿破仑(1个,价值238元)\n 16cm*16cm,约2磅左右\n- 精美蛋糕刀叉(1套,赠送)\n 含5个盘子、5个叉子、5张餐巾纸、1把餐刀、蛋糕盒1个、精美拎袋1个\n \n",
      "image_url": "http://t2.s2.dpfile.com/pc/mc/e75efd4b642251e21af2691a9df77399(450x280)/thumb.jpg",
      "s_image_url": "http://t1.s2.dpfile.com/pc/mc/e75efd4b642251e21af2691a9df77399(160x100)/thumb.jpg",
      "more_image_urls": [
        "http://t3.s2.dpfile.com/pc/mc/e75efd4b642251e21af2691a9df77399(450x1024)/thumb.jpg",
        "http://t3.s1.dpfile.com/pc/mc/cffd005b1a94a55cb59fb8494ea09804(450x1024)/aD0xMDI0Jms9L3BjL21jL2NmZmQwMDViMWE5NGE1NWNiNTlmYjg0OTRlYTA5ODA0JmxvZ289MCZtPXgmdz00NTA.a57d8a56f07afd7ce322cc6abbcac896/thumb.jpg",
        "http://t2.s2.dpfile.com/pc/mc/004b104c126a4319a55ac0f999d44419(450x1024)/thumb.jpg"
      ],
      "more_s_image_urls": [
        "http://t3.s2.dpfile.com/pc/mc/e75efd4b642251e21af2691a9df77399(450x1024)/thumb_1.jpg",
        "http://t3.s1.dpfile.com/pc/mc/cffd005b1a94a55cb59fb8494ea09804(450x1024)/aD0xMDI0Jms9L3BjL21jL2NmZmQwMDViMWE5NGE1NWNiNTlmYjg0OTRlYTA5ODA0JmxvZ289MCZtPXgmdz00NTA.a57d8a56f07afd7ce322cc6abbcac896/thumb_1.jpg",
        "http://t2.s2.dpfile.com/pc/mc/004b104c126a4319a55ac0f999d44419(450x1024)/thumb_1.jpg"
      ],
      "is_popular": 1,
      "restrictions": {
        "is_reservation_required": 1,
        "is_refundable": 1,
        "special_tips": "购买须知\n \n有效期 \n2013-10-25 至 2014-01-24\n \n预约 \n必须至少提前1-2天致电商家预约\n \n使用须知 \n仅限外带,外带免费\n仅限到店自提,不提供配送服务\n每天最多接受30张团购预约\n本团购设定3个提货点:\n1.喜玛拉雅中心:浦东新区芳甸路1188弄证大喜玛拉雅中心1-4号B1楼158号(近国际会展中心)(提货时间为:12:00-20:00)\n2.静安寺点:上海市静安区北京西路1701号静安中华大厦305室(靠近久光百货,地铁2号线静安寺站出口,步行约10分钟)(提货时间周一至周五:12:00-17:30) \n3 月星环球港店:普陀区中山北路3300号月星环球港4楼L4051室(提货时间为:12:00-20:00)\n电话预约时请告知团购验证码,提货时间和确定的提货地点,若提货时间和地点有变动,为保证蛋糕的美味和新鲜,务必提前1天电话告知,并且商家会做好您的信息改动记录\n拿破仑蛋糕保鲜及最佳食用时间为当天;若您是使用于生日蛋糕,可提前告知商家,将会免费为您提供数字生日蜡烛\n \n温馨提示 \n不可与其他优惠同享\n如需团购券发票,请在消费时向商户提出\n \n \n"
      },
      "notice": "",
      "deal_url": "http://dpurl.cn/p/gDbP5obfsx",
      "deal_h5_url": "http://dpurl.cn/p/5bq8ZY4jCa",
      "commission_ratio": 0.03,
      "businesses": [
        {
          "name": "Le Camelia(月星环球港店)",
          "id": 13668043,
          "city": "上海",
          "address": "中山北路3300号月星环球港4楼L4051室",
          "latitude": 31.23251,
          "longitude": 121.41204,
          "url": "http://dpurl.cn/p/mE0A2CNMJv",
          "h5_url": "http://dpurl.cn/p/F568FsEEAY"
        },
        {
          "name": "Le Camelia(喜玛拉雅中心店)",
          "id": 5710539,
          "city": "上海",
          "address": "芳甸路1188弄证大喜玛拉雅中心1-4号B1楼158号",
          "latitude": 31.21005,
          "longitude": 121.56168,
          "url": "http://dpurl.cn/p/O7qU9ZrzaV",
          "h5_url": "http://dpurl.cn/p/S+3UKW9Is+"
        }
      ]
    }
  ]
}