API文档 >>  获取指定商户最新点评片断

  • API名称: 获取指定商户最新点评片断 review/get_recent_reviews
  • 描述:获取指定商户的最新三条用户点评前50字片断
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/review/get_recent_reviews

请求参数

  • 必选参数

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

    名称 类型 说明
    platform int 传出链接类型,1:web站链接(适用于网页应用),2:HTML5站链接(适用于移动应用和联网车载应用),如不传入,默认值为1
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json
    limit int 返回的点评条目数,最小值1,最大值3,如不传入默认为3

返回结果

  • 状态字段

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

    名称 类型 说明
    review_id int 单条点评ID
    user_nickname string 该条点评作者用户名
    created_time string 点评创建时间
    text_excerpt string 点评文字片断,前50字
    review_rating float 点评作者提供的星级评分,5.0代表五星,4.5代表四星半,依此类推
    rating_img_url string 星级图片链接
    rating_s_img_url string 小尺寸星级图片链接
    product_rating int 产品/食物口味评价,0:差,1:一般,2:好,3:很好,4:非常好
    decoration_rating int 环境评价,0:差,1:一般,2:好,3:很好,4:非常好
    service_rating int 服务评价,0:差,1:一般,2:好,3:很好,4:非常好
    review_url string 点评页面链接
    additional_info.more_reviews_url string 全部点评页面链接

注意事项

API测试工具

示例请求

http://api.dianping.com/v1/review/get_recent_reviews?business_id=5429278&appkey=[appkey]&sign=[signature]

示例结果

{
  "status": "OK",
  "count": 3,
  "reviews": [
    {
      "review_id": 49302627,
      "user_nickname": "HcjTT1314",
      "created_time": "2013-11-27 23:56",
      "text_excerpt": "外婆家的性价比和味道,吃过的都知道没什么好说的,平时都要排队排很久,今天运气很好,过去了直接开吃。",
      "review_rating": 5,
      "rating_img_url": "http://i3.dpfile.com/s/i/app/api/32_5star.png",
      "rating_s_img_url": "http://i2.dpfile.com/s/i/app/api/16_5star.png",
      "product_rating": 3,
      "decoration_rating": 4,
      "service_rating": 3,
      "review_url": "http://dpurl.cn/p/tn-RH4CDWq"
    },
    {
      "review_id": 49302262,
      "user_nickname": "附庸风雅之人",
      "created_time": "2013-11-27 23:45",
      "text_excerpt": "非常不错的一家店 平时来基本不用怎么排队 奥义就是便宜。 现在这种物价",
      "review_rating": 5,
      "rating_img_url": "http://i3.dpfile.com/s/i/app/api/32_5star.png",
      "rating_s_img_url": "http://i1.dpfile.com/s/i/app/api/16_5star.png",
      "product_rating": 4,
      "decoration_rating": 4,
      "service_rating": 4,
      "review_url": "http://dpurl.cn/p/8SyN1cZJKf"
    },
    {
      "review_id": 49301850,
      "user_nickname": "joyboa",
      "created_time": "2013-11-27 23:34",
      "text_excerpt": "酒酿圆子不是很甜〜还行〜中午生意真是好啊〜人一多,略感有点吵…",
      "review_rating": 5,
      "rating_img_url": "http://i1.dpfile.com/s/i/app/api/32_5star.png",
      "rating_s_img_url": "http://i1.dpfile.com/s/i/app/api/16_5star.png",
      "product_rating": 4,
      "decoration_rating": 4,
      "service_rating": 4,
      "review_url": "http://dpurl.cn/p/9s7WHMznvm"
    }
  ],
  "additional_info": {
    "more_reviews_url": "http://dpurl.cn/p/84VMxE5Ots"
  }
}