方法名称
hotel.incr.data
使用说明
本接口用于监测产品的库存和价格的变化,用于实时搜索模式中缓存数据的更新。当获取到增量信息时,调用hotel.detail获取最新的库存价格信息。 保存返回值中LastId最大值作为下一次调用时的入参。
如果使用该接口,请结合hotel.incr.id接口使用。
[注意]本接口不能获取直连酒店(目前是万豪集团的酒店)的数据的变化;其报价请使用hotel.detail接口。
[注意]不再建议使用,废弃。
搜索模式需要不断轮询hotel.detail来覆盖产品所有变化;如想更及时感知库存、价格变化,可以搭配hotel.incr.sharding.inv、hotel.incr.sharding.rate分片增量接口作为补充;注意分片增量接口为离线模式相关接口,离线模式产品要比搜索模式多,相关的增量也会多,拿到增量需先判断是本地缓存过的产品才是有用的增量,并且分片价格不会包含促销价格,拿到增量需再次调用详情获取最新价格,增量给出的价格无效、库存无效可直接将本地缓存也置为无效。
输入参数
节点 | 名称 | 类型 | 可为空 | 说明 |
---|---|---|---|---|
LastId | 最后的更新ID | Long | N | |
Count | 抓取的数量 | Integer | Y | 不传,默认:1000;最大不能超过5000 |
响应结果
节点 | 名称 | 类型 | 可为空 | 说明 |
---|---|---|---|---|
Hotels | 变化了的酒店列表 | Hotel[] | Y | 包含多个 Hotel节点 |
Hotel节点
节点 | 名称 | 类型 | 可为空 | 说明 |
---|---|---|---|---|
LastId | 增量ID | Long | N | |
Time | 变化时间 | Datetime | N | |
HotelID | 发生变化的酒店 | String | N | |
StartDate | 变化的开始时间 | Date | N | |
EndDate | 变化的结束时间 | Date | N |
输入参数示例
https://api-test.elong.com/rest?timestamp=1489990882&format=json &method=hotel.incr.data&signature=66a1a2b7d3bc7e0d0d58d885d4489665 &user={userid}&data={"Version":"1.28","Local":"zh_CN","Request":{"LastId":"1"}}
输出参数示例
{ "Code": "0", "Result": { "Hotels": [ { "LastId": 7448010641, "Time": "2016-10-27T09:42:26 08:00", "HotelID": "40101006", "StartDate": "2016-10-27T00:00:00 08:00", "EndDate": "2016-11-27T00:00:00 08:00" } ] }, "Guid": "90462b2e-fc10-477f-923d-69499802a8ca" }
常见错误码
错误码 | 解释 | 解决方案 |
---|---|---|
H000997 | 未知异常 | 重试,反复出现请联系技术支持人员 |