绿色节点为可选节点,蓝色节点为必选节点
每个API底层都有API整体限流,以及对每个appkey的限流,超过限流会拦截,严重影响及时更新,建议商家合理控制调用频率,结合多个库存房价接口调用,并不断优化更新有效数据、提升调用成功率。以下的各种QPS会随着业务发展视情况变化。
API接口名称 | API限流 | appkey限流 |
---|---|---|
taobao.xhotel.rateplan.update | 700QPS | 60QPS以下 |
taobao.xhotel.room.update | 300QPS | 50QPS |
taobao.xhotel.rate.update | 500QPS | 60QPS |
taobao.xhotel.rates.increment | 750QPS | 60QPS |
taobao.xhotel.rates.update | 1000QPS | 110QPS |
API接口 | 接口说明 |
---|---|
taobao.xhotel.add | 该接口支持酒店信息的新增和修改,其中入参outer_id必须卖家唯一。 |
taobao.xhotel.update | 该接口支持酒店信息的新增和修改,其中入参outer_id必须卖家唯一。 |
taobao.xhotel.house.add | 非标准民宿房源添加或更新接口,其中入参outer_id必须卖家唯一。 |
API接口 | 接口说明 |
---|---|
taobao.xhotel.roomtype.add | 该接口支持房型信息的新增和修改,其中入参outer_id必须卖家唯一。 |
taobao.xhotel.roomtype.update | 该接口支持房型信息的新增和修改,其中入参outer_id必须卖家唯一。 |
taobao.xhotel.house.roomtype.add | 该接口支持民宿房型信息的新增和修改,其中入参outer_id必须卖家唯一。 |
API接口 | 接口说明 |
---|---|
taobao.xhotel.rateplan.add | 该接口支持房价信息的新增和修改,对接该接口的时候务必注意payment_type,cancel_policy,guarantee_type三个字段的约束关系 |
taobao.xhotel.rateplan.update | 该接口支持房价信息的新增和修改,对接该接口的时候务必注意payment_type,cancel_policy,guarantee_type三个字段的约束关系 |
API接口 | 接口说明 |
---|---|
taobao.xhotel.room.update | 房型库存推送接口(全量推送),此接口用于全量更新单个房型的房型库存、房态 |
taobao.xhotel.rooms.update | 房型库存推送接口(批量全量),此接口用于全量更新多个房型的房型库存、房态 |
taobao.xhotel.rooms.increment | 房型库存推送接口(批量增量),此接口用于增量更新多个房型的房型库存、房态即传哪天的库存、房态就更新哪天的 |
taobao.xhotel.rate.update | 单个(房型+价格计划)更新全量库存,此接口用于全量更新单个房型和房价维度的库存价格信息 |
taobao.xhotel.rates.update | 多个(房型+价格计划)全量库存更新,此接口用于全量更新多个房型和房价维度的全部库存价格信息 |
taobao.xhotel.rates.increment | 多个(房型+价格计划)增量库存价格,此接口用于增量更新多个房型和房价维度的库存信息即传哪天的价格库存就更新哪天的 |
taobao.xhotel.multiplerate.update | 复杂价格推送接口(全量更新),此接口用于全量更新单个房型和房价维度的库存价格信息 |
taobao.xhotel.multiplerates.update | 复杂价格推送接口(批量全量),此接口用于全量更新多个房型和房价维度的全部库存价格信息 |
taobao.xhotel.multiplerates.increment | 复杂房价推送接口(批量增量),此接口用于增量更新多个房型和房价维度的库存信息即传哪天的价格库存就更新哪天的 |
一个房型+一个rateplan=一个rate对象,即房型和房价绑定产生一个实际最小可售单元。以上接口根据商家需求进行选择对接,商家可同时对接room库存接口以及rate库存接口,room接口是房型共享库存,含rate的接口是专有库存。房型下绑定的各种房价码均可自由选择使用room共享库存还是rate专有库存。为了提高用户试单体验,房型上若有长期的固定的多个房价绑定且使用同样的库存来源时,建议这些rate对象用room库存;临时的阶段性的个性化的促销活动,用rate库存。同时建议单个全量、批量全量、批量增量接口兼顾使用。
rate接口中的参数use_room_inventory标识此rate对象是用rate接口附带的rate库存还是room接口推送的room库存。
复杂价格即支持(多人价,连住价等)
rate接口中的库存,价格,开关都是独立更新的,更新库存为0或者关房,不必一定要更新价格,如果必须要默认价格,需卖家默认price为-1
API接口 | 接口说明 |
---|---|
taobao.xhotel.rate.update | 单个(房型+价格计划)更新全量价格,此接口用于全量更新单个房型和房价维度的库存价格信息 |
taobao.xhotel.rates.update | 多个(房型+价格计划)全量价格更新,此接口用于全量更新多个房型和房价维度的全部库存价格信息 |
taobao.xhotel.rates.increment | 多个(房型+价格计划)增量库存价格,此接口用于增量更新多个房型和房价维度的库存信息即传哪天的价格库存就更新哪天的 |
taobao.xhotel.multiplerate.update | 复杂价格推送接口(全量更新),此接口用于全量更新单个房型和房价维度的库存价格信息 |
taobao.xhotel.multiplerates.update | 复杂价格推送接口(批量全量),此接口用于全量更新多个房型和房价维度的全部库存价格信息 |
taobao.xhotel.multiplerates.increment | 复杂房价推送接口(批量增量),此接口用于增量更新多个房型和房价维度的库存信息即传哪天的价格库存就更新哪天的 |
复杂价格(multiplerate接口)即支持多人价、连住价、税费、加人价等,商家可根据实际需求对接复杂价格
简单价格(rate接口)即按房间进行定价
rate接口中的库存,价格,开关都是独立更新的,更新库存为0或者关房,不必一定要更新价格,如果必须要默认价格,需卖家默认price为-1
特别说明,若商家不用room库存接口,使用rate接口同时推送库存和价格,即第四步推库存和第五步推价格就一起实现了。虽然日历库存为0、日历关房,都实现了当天不可售,建议推送能反映实际场景(即库存为0是酒店设置的0,日历关房是酒店设置的日历关),方便卖家管理可售情况。
API接口 | 接口说明 |
---|---|
taobao.xhotel.rateplan.delete | 价格计划删除接口,同时删除级联的rate |
taobao.xhotel.rate.delete | rate删除接口,该接口用户删除酒店价格 |
taobao.xhotel.delete | 酒店删除接口,用于删除酒店以及该酒店下的房型 |
taobao.xhotel.roomtype.delete.public | 房型删除接口,用户删除房型 |