API文档 >>   获取指定时间内卖完的团购ID列表

  • API名称:  获取指定时间内卖完的团购ID列表 deal/get_sold_out_id_list
  • 描述:获取指定城市、指定时间内卖完的团购ID列表
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/deal/get_sold_out_id_list

请求参数

  • 必选参数

    名称 类型 说明
    appkey string App Key,应用的唯一标识
    sign string 请求签名,生成方式见《API请求签名生成文档》
    city string 包含团购信息的城市名称,可选范围见相关API返回结果
    begin_time string 查询起始时间,格式为“YYYY-MM-DD hh:mm:ss”
    end_time string 查询结束时间,格式为“YYYY-MM-DD hh:mm:ss”
  • 可选参数

    名称 类型 说明
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json

返回结果

  • 状态字段

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

    名称 类型 说明
    id_list list 团购单ID列表

注意事项

  • 团购从可购买变为不可购买分为两种情况:一是过购买截止期下线,二是尚未到截止购买日期但提前卖完下线。此API仅返回特定时间段内提前卖完下线的团购ID列表

API测试工具

示例请求

http://api.dianping.com/v1/deal/get_sold_out_id_list?city=北京&begin_time=2013-04-20 00:00:00&end_time=2013-04-25 18:00:00&appkey=[appkey]&sign=[signature]

示例结果

{
  "status": "OK",
  "count": 20,
  "id_list": [
    "1-88457",
    "1-108304",
    "1-112699",
    "1-114952",
    "1-116905",
    "......"
  ]
}