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" } }