API测试>>

酒店

国内酒店-分片库存增量更新时间:2024/12/31 10:49

方法名称

hotel.incr.sharding.inv

使用说明

本接口对比实时hotel.detail接口缺少折扣优惠,价格竞争力低,非必要尽量不对接此接口。

本接口用于监测库存的变化,用于离线数据模式中缓存数据的更新。当获取到增量信息时,将结果中的信息覆盖原有数据。


记录返回是按LastId有序的,请按照顺序处理。保存返回值中LastId最大值作为下一次调用时的入参。

本接口与hotel.incr.inv出参结构相同,不同的是入参增加了ShardingKey来指定查询相对应的分片数据。

输入参数

节点名称类型可为空说明
LastId最后的更新IDLongN
ShardingKey分片键IntegerN1-16,用于查询指定分片数据
Count抓取的数量IntegerY不传,默认:1000;最大不能超过5000

响应结果

节点名称类型可为空说明
Inventories库存变化集合Inventory[]Y包含多个Inventory节点


Inventory节点

节点名称类型可为空说明
LastId增量IDLongN
Time变化时间DatetimeN
HotelId酒店IDString(8)N这几个属性是业务主键。
Date属性就是表示本记录是其对应日期的库存。
RoomTypeId房型IDString(10)N
HotelCode酒店编码String(8)N
Date库存时间DateN
Status库存状态BooleanNTrue: 表示当天房态为可用,需要更新本地房态
False:表示当天房态为无效,需关闭本地房态
Amount库存数量IntN
OverBooking超售状态IntN0---可超售,可以卖出超过Amount的房间数量
1—不可超售,只能销售Amount及以下的房间数量
StartDate可用开始日期DateN
EndDate可用结束日期DateN
StartTime可用开始时间TimeN
EndTime可用结束时间TimeN
IsInstantConfirm当天库存是否支持即时确认BooleanYV1.33新增
IC_BeginTime预订当天即时确认可用开始时间TimeY
IC_EndTime预订当天即时确认可用结束时间TimeY

输入参数示例

https://api-test.elong.com/rest?timestamp=1490001050&format=json
&method=hotel.incr.sharding.inv&signature=d19ce1e910def16453801405581c9d7c
&user={userid}&data={"Version":"1.28","Local":"zh_CN","Request":{"LastId":"1","ShardingKey":"1"}}

输出参数示例

{
    "Code": "0",
    "Result": {
        "Inventories": [
            {
                "LastId": 2048,
                "Time": "2017-03-20T09:10:00 08:00",
                "HotelID": "40101025",
                "RoomTypeId": "1114",
                "HotelCode": "40101025",
                "Date": "2017-03-21T00:00:00 08:00",
                "Status": true,
                "Amount": 3,
                "OverBooking": 0,
                "StartDate": "2016-04-13T14:07:36 08:00",
                "EndDate": "2017-03-21T23:59:59 08:00",
                "StartTime": "00:00:00",
                "EndTime": "18:00:00"
            }
        ]
    },
    "Guid": "4b59297d-1d60-457c-89f6-c8b2ee730aea"
}