API文档 >>  批量获取支持在线预订的商户信息

  • API名称: 批量获取支持在线预订的商户信息 Business/get_batch_businesses_by_id
  • 描述:根据多个商户ID批量获取商户的详细信息
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/reservation/get_batch_businesses_with_reservations_by_id

请求参数

  • 必选参数

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

    名称 类型 说明
    out_offset_type int 传出经纬度偏移类型,1:高德坐标系偏移,2:图吧坐标系偏移,如不传入,默认值为1
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json

返回结果

  • 状态字段

    名称 类型 说明
    status string 本次API访问状态,如果成功返回"OK",并返回结果字段,如果失败返回"ERROR",并返回错误说明
    count int 本次API访问所获取的商户数量(调用此API,返回值恒为1)
  • 结果字段

    名称 类型 说明
    business_id int 商户ID
    name string 商户名
    branch_name string 分店名
    address string 地址
    telephone string 带区号的电话
    city string 所在城市
    regions list 所在区域信息列表,如[徐汇区,徐家汇]
    categories list 所属分类信息列表,如[宁波菜,婚宴酒店]
    latitude float 纬度坐标
    longitude float 经度坐标
    photo_url string 照片链接,照片最大尺寸700×700
    s_photo_url string 小尺寸照片链接,照片最大尺寸278×200
    has_online_reservation int 是否支持在线预订,0:没有,1:有
    online_reservation_url string 在线预订WWW站点页面链接
    online_reservation_h5_url string 在线预订页面HTML5站点链接

注意事项

  • 如果输入的ID对应的商户不支持在线预订,则忽略掉此ID

API测试工具

示例请求

http://api.dianping.com/v1/reservation/get_batch_businesses_with_reservations_by_id?appkey=[appkey]&sign=2C6CD8F5987279FB3E4C6C849E2039BAB0A1569B&business_ids=5429278

示例结果

{
  "status": "OK",
  "count": 1,
  "businesses": [
    {
      "business_id": 5429278,
      "name": "外婆家",
      "branch_name": "南京西路店",
      "address": "静安区南京西路818号818广场701室",
      "telephone": "021-52397225",
      "city": "上海",
      "regions": [
        "静安区",
        "南京西路"
      ],
      "categories": [
        "杭帮菜"
      ],
      "latitude": 31.23122,
      "longitude": 121.46103,
      "business_url": "http://dpurl.cn/p/Q2qwFHIQ8R",
      "business_h5_url": "http://dpurl.cn/p/86PqxofvAQ",
      "photo_url": "http://i1.dpfile.com/pc/41451826b1cc54f71863d33ce98ec1bf(700x700)/thumb.jpg",
      "s_photo_url": "http://i2.dpfile.com/pc/41451826b1cc54f71863d33ce98ec1bf(278x200)/thumb.jpg",
      "has_online_reservation": 1,
      "online_reservation_url": "http://dpurl.cn/p/t88QtQC9uZ",
      "online_reservation_h5_url": "http://dpurl.cn/p/0Gf0aTCYoM"
    }
  ]
}