API测试>>

酒店

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

方法名称

hotel.incr.sharding.rate

使用说明

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

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


本接口返回的价格数据也是原始价格。
记录返回是按LastId有序的,请按照顺序处理。保存返回值中LastId最大值作为下一次调用时的入参。


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

输入参数

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


响应结果

节点名称类型可为空说明
Rates价格变化集合Rate[]Y包含多个Rate节点


Rate节点

节点名称类型可为空说明
LastId增量IDLongN
Time变化时间DatetimeN
HotelId酒店IDString(8)N这几个属性是业务主键
RoomTypeId房型IDString(10)N
RateplanId产品 IDIntN
StartDate开始时间DateN
EndDate结束时间DateN
HotelCode酒店编码String(8)YV1.13新增
Staus状态BooleanNTrue:表示当条记录对应的房价为有效,需覆盖更新本地数据
False:表示当条记录对应的房价为无效,需更新本地价格为无效
Member平日卖价DecimalN具体使用的是平日卖价还是周末卖价,需要根据HotelCode查找hotel.data.rp中对应的酒店周末设置
Weekend周末卖价DecimalN
MemberCost平日底价DecimalN同上
WeekendCost周末底价DecimalN
AddBed加床价DecimalYV1.06新增
-1代表不能加床,0-免费加床,大于0表示加床的费用
PriceID价格IDLongYV1.08新增
不能作为更新变化的主键。该字段已废弃
CurrencyCode货币类型StringYV1.08新增
参考Currency
InvoiceMode发票模式IntY

V1.14新增

0:全部(默认值,未区分)

1:艺龙开票

2:酒店开票

IsPriceLimit是否限价BooleanN

表示当前价格是否限价 ,限价时须按照艺龙给出的售价进行售卖。

多天连住时,有一天为true,则所有天限价。

判断限价时与hotel.data.rp接口中IsPriceLimitProduct字段为或关系,两者有其一为true,均为限价。

false:非限价

true:限价

PriceLimitedType限价类型IntN

二进制bit位分别表示各个限价条件,详见

输入参数示例

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

输出参数示例

{
    "Code": "0",
    "Result": {
        "Rates": [
            {
                "LastId": 5039773317,
                "Time": "2016-12-11T17:37:57 08:00",
                "HotelID": "30101023",
                "HotelCode": "30101023",
                "RoomTypeId": "1077",
                "RateplanId": 25227,
                "StartDate": "2016-12-11T00:00:00 08:00",
                "EndDate": "2017-01-11T00:00:00 08:00",
                "Status": true,
                "Member": 100,
                "Weekend": 100,
                "MemberCost": -1,
                "WeekendCost": -1,
                "AddBed": -1,
                "PriceID": 1233478686,
                "CurrencyCode": "RMB"
            }
        ]
    },
    "Guid": "4b59297d-1d60-457c-89f6-c8b2ee730aea"
}