API测试>>

酒店

国内酒店-酒店增量更新时间:2024/03/08 18:38

方法名称

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 未知异常 重试,反复出现请联系技术支持人员