获取变更的团购ID列表-开发文档-大众点评开发者平台

API文档 >> 获取变更的团购ID列表

API名称：获取变更的团购ID列表 deal/get_incremental_id_list
描述：获取指定城市当前在线的全部团购ID列表
数据格式：JSON/XML
方法：HTTP GET
等级：普通
是否需要用户授权：否
请求URL：http://api.dianping.com/v1/deal/get_incremental_id_list

请求参数

必选参数

名称	类型	说明
appkey	string	App Key，应用的唯一标识
sign	string	请求签名，生成方式见《API请求签名生成文档》
begin_time	string	变更的开始时间，格式为“yyyy-MM-dd HH:mm:ss“，开始时间不得早于当前时间12个小时
city	string	包含团购信息的城市名称，支持最多5个城市合并查询，城市之间使用英文逗号分隔，可选范围见相关API返回结果

可选参数

名称	类型	说明
category	string	包含团购信息的分类名称，支持最多5个category合并查询，多个category用逗号分割，可选范围见相关API返回结果
format	string	返回数据格式，可选值为json或xml，如不传入，默认值为json

返回结果

状态字段

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

结果字段

名称	类型	说明
id_list	list	团购单ID列表
id_list.deal_id	string	团购单ID
id_list.status	int	当前状态，0：已下线，1：新上线，2：内容变更
id_list.city	string	团购单所在的城市
id_list.update_time	string	当前团单的变更具体时间戳
additional_info.update_time	string	当前数据的变更时间戳，建议作为下一次变更数据查询的开始时间

注意事项

begin_time不得早于当前时间12小时，建议根据实际需求每隔一段时间请求一次变更信息

API测试工具

示例请求

http://api.dianping.com/v1/deal/get_incremental_id_list?city=上海&appkey=[appkey]&sign=[signature]&begin_time=2014-1-20 16:00:00&category=美食

示例结果

{
  "status": "OK",
  "count": 3,
  "id_list": [
    {
      "deal_id": "1-118920",
      "status": 2,
      "city": "上海",
      "update_time": "2014-01-20 16:00:00"
    },
    {
      "deal_id": "1-2124378",
      "status": 2,
      "city": "上海",
      "update_time": "2014-01-20 16:00:01"
    },
    {
      "deal_id": "1-5062518",
      "status": 2,
      "city": "上海",
      "update_time": "2014-01-20 16:17:42"
    }
  ],
  "additional_info": {
    "update_time": "2014-01-20 16:28:55"
  }
}

反馈