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

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

请求参数

  • 必选参数

    名称 类型 说明
    appkey string App Key,应用的唯一标识
    sign string 请求签名,生成方式见《API请求签名生成文档》
    business_id int 商户ID
  • 可选参数

    名称 类型 说明
    out_offset_type int 传出经纬度偏移类型,1:高德坐标系偏移,2:图吧坐标系偏移,如不传入,默认值为1
    platform int 传出链接类型,1:web站链接(适用于网页应用),2:HTML5站链接(适用于移动应用和联网车载应用),如不传入,默认值为1
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json

返回结果

  • 状态字段

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

    名称 类型 说明
    business_id int 商户ID
    name string 商户名
    branch_name string 分店名
    address string 地址
    telephone string 带区号的电话
    city string 所在城市
    regions list 所在区域信息列表,如[徐汇区,徐家汇]
    categories list 所属分类信息列表,如[宁波菜,婚宴酒店]
    latitude float 纬度坐标
    longitude float 经度坐标
    avg_rating float 星级评分,5.0代表五星,4.5代表四星半,依此类推
    rating_img_url string 星级图片链接
    rating_s_img_url string 小尺寸星级图片链接
    product_grade int 产品/食品口味评价,1:一般,2:尚可,3:好,4:很好,5:非常好
    decoration_grade int 环境评价,1:一般,2:尚可,3:好,4:很好,5:非常好
    service_grade int 服务评价,1:一般,2:尚可,3:好,4:很好,5:非常好
    product_score float 产品/食品口味评价单项分,精确到小数点后一位(十分制)
    decoration_score float 环境评价单项分,精确到小数点后一位(十分制)
    service_score float 服务评价单项分,精确到小数点后一位(十分制)
    avg_price int 人均价格,单位:元,若没有人均,返回-1
    review_count int 点评数量
    review_list_url list 点评页面URL链接
    hours string 营业时间(例:周一—周五 :午市11:00—14:00)
    business_url string 商户页面链接
    popular_dishes string 推荐菜
    photo_url string 照片链接,照片最大尺寸700×700
    specialties string 商户标签(无线上网,可以刷卡,朋友聚餐)
    s_photo_url string 小尺寸照片链接,照片最大尺寸278×200
    has_takeaway int 是否有外卖,0:没有,1:有
    photo_count int 照片数量
    has_queue int 是否有排队,0:没有,1:有
    photo_list_url list 照片页面URL链接
    has_shanhui int 是否有闪惠,0:没有,1:有
    has_coupon int 是否有优惠券,0:没有,1:有
    shanhui_title string 闪惠标题(如:每满100减10、6.9折等)
    coupon_id int 优惠券ID
    qr_code string 二维码(base64形式)
    coupon_description string 优惠券描述
    biz_hour string 当天营业时间
    coupon_url string 优惠券页面链接
    has_deal int 是否有团购,0:没有,1:有
    deal_count int 商户当前在线团购数量
    deals list 团购列表
    deals.id string 团购ID
    deals.description string 团购描述
    deals.url string 团购页面链接
    has_online_reservation int 是否有在线预订,0:没有,1:有
    online_reservation_url string 在线预订页面链接,目前仅返回HTML5站点链接

注意事项

  • 通过审核前,返回的是测试数据;通过审核后,返回的是正式数据
  • online_reservation_url,目前仅返回HTML5站点链接

API测试工具

示例请求

http://api.dianping.com/v1/business/get_single_business?business_id=9964442&appkey=[appkey]&sign=[signature]

示例结果

{
  "status": "OK",
  "count": 1,
  "businesses": [
    {
      "business_id": 6162303,
      "name": "70后饭吧",
      "branch_name": "中环百联店",
      "address": "普陀区真光路1288号百联中环购物广场4楼",
      "telephone": "021-61397933",
      "city": "上海",
      "regions": [
        "普陀区",
        "梅川路"
      ],
      "categories": [
        "本帮江浙菜",
        "川菜"
      ],
      "latitude": 31.245836,
      "longitude": 121.38308,
      "avg_rating": 4.0,
      "rating_img_url": "http://i3.dpfile.com/s/i/app/api/32_4star.png",
      "rating_s_img_url": "http://i2.dpfile.com/s/i/app/api/16_4star.png",
      "product_grade": 2,
      "decoration_grade": 3,
      "service_grade": 3,
      "product_score": 7.6,
      "decoration_score": 8.2,
      "service_score": 7.8,
      "review_count": 2645,
      "review_list_url": "http://lite.m.dianping.com/BfCeRQiP-4",
      "avg_price": 65,
      "business_url": "http://dpurl.cn/p/2qOiJEcgEu",
      "photo_url": "http://i2.dpfile.com/pc/2cc774cdf2400e20521c6aebede4bf55(700x700)/thumb.jpg",
      "s_photo_url": "http://i1.dpfile.com/pc/2cc774cdf2400e20521c6aebede4bf55(278x200)/thumb.jpg",
      "photo_count": 3100,
      "photo_list_url": "http://lite.m.dianping.com/sg3kCRyAHr",
      "has_coupon": 0,
      "coupon_id": 0,
      "coupon_description": "",
      "coupon_url": "",
      "has_deal": 0,
      "deal_count": 0,
      "deals": [],
      "has_online_reservation": 0,
      "online_reservation_url": ""
    }
  ]
}