文档中心 > 酒店客栈-线上预订

酒店商品发布

更新时间:2019/05/06 访问次数:17944

商品推送步骤

绿色节点为可选节点,蓝色节点为必选节点

image

接口说明

接口限流

每个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对每个appkey限流是为了防止个别appkey恶意调用影响其他appkey的调用,因API底层整体限流保护,因此不保证每个appkey在以上限流阀值内全部调用成功,当API整体限流时,对所有appkey机会均等。随着商家业务发展可提交工单申请提升应用流量(条件:接口调用成功率90%以上)。当单个appkey给多个卖家使用时,需考虑appkey调用量、API限流对业务影响,必要时需申请多个appkey。

新增酒店

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必须卖家唯一。
  • 酒店选第一或第二个或两个接口兼用,非标名宿只能选第三个接口

新增Rateplan价格计划

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 房型删除接口,用户删除房型

FAQ

关于此文档暂时还没有FAQ
返回
顶部