API测试>>

酒店

国内酒店-状态增量更新时间:2024/12/31 10:48

方法名称

hotel.incr.state

使用说明

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

    请使用新接口:hotel.incr.sharding.state

    本接口用于监测产品信息的变化,用于离线数据模式。

    保存返回值中LastId最大值作为下一次调用时的入参。

输入参数

节点名称类型可为空说明
LastId最后的更新IDLongN
Count抓取的数量IntegerY不传,默认:1000;最大不能超过5000

响应结果

节点名称类型可为空说明
States变化集合State[]Y包含多个State节点


State节点

节点名称类型可为空说明
LastId增量IdLongN
Time变化时间DataTimeN
HotelId酒店编号string(8)N
HotelCode酒店供应商编码string(8)Y
RoomId展示房型IDstring(8)Y
RoomTypeId销售房型编号string(8)Y
RatePlanId产品编号intY
Name对象的名称string(100)Yv1.17增加。记录变化的HotelId、RoomId对应的酒店和房间的名称
Status有效状态booleanY当StateType为RatePlanPolicy的时候Status无意义
StateType变化类型EnumNHotelId:酒店
HotelCode:酒店供应商
RoomId:展示房型
RoomTypeId:销售房型
RatePlanId:产品
RatePlanPolicy:担保或预付规则

输入参数示例

https://api-test.elong.com/rest?timestamp=1490002719&format=json
&method=hotel.incr.state&signature=8fdf631c1e6008efdcbb36984611d8cb
&user={userid}&data={"Version":"1.28","Local":"zh_CN","Request":{"LastId":"883554652"}}

输出参数示例

{
    "Code": "0",
    "Result": {
        "States": [
            {
                "LastId": 883554653,
                "Time": "2016-09-28T16:16:47 08:00",
                "HotelId": "40101025",
                "HotelCode": "40101025",
                "RatePlanId": "8714",
                "Status": true,
                "StateType": "RatePlanId",
                "Name": "2—限时抢购"
            }
        ]
    },
    "Guid": "4b59297d-1d60-457c-89f6-c8b2ee730aea"
}

注意事项

如果StateType是RatePlanPolicy时,需要调用hotel.data.rp接口获取最新的产品信息,其他则关注Status。