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