在线演示

住宿API

面向酒店、公寓和度假租赁的住宿API

住宿API把各类住宿送到您的预订网站:酒店客房、服务式公寓、度假屋、青年旅舍和民宿。本页讲解一次住宿背后的数据、租赁与酒店不同的规则,以及PHPTRAVELS如何在一次搜索中同时销售您自己的房源和供应商库存。

  • 房源、单元、价格方案、日历
  • 最少入住晚数与费用
  • 取消期限
  • 自有库存加API供应

数据模型

每次住宿都包含四个层级

无论是300间客房的酒店,还是一栋海边小屋,住宿API都用同样的四个嵌套层级来描述。每一层回答客人订房前会问的不同问题。

01房源

住宿地点本身:名称、类型、地址与地图位置、照片、设施、星级或品质评分、入住规则和入住时间。

property_id · type · address · geo · photos · amenities · check_in_from

02客房或单元

实际被预订的对象:一种房型、一整套公寓或宿舍里的一张床,包含面积、床位和最多入住人数。

unit_id · beds · size_m2 · max_adults · max_children

03价格方案

该单元的销售方式:餐食安排、取消政策、付款条件,以及谁可以预订,例如公开或仅限代理。

rate_plan_id · board · cancel_policy · payment · channel

04可订状态

每晚一行:价格、剩余单元数、最少入住晚数,以及当天是否允许入住或退房。

date · price · units_left · min_stay · closed_to_arrival

把一个住宿房源绘制成建筑、客房、价格标签和日历四个相互堆叠的层级

PHPTRAVELS把住宿模块命名为Stays,因为同一个模型涵盖的远不止酒店。一个房源包含多个单元,一个单元通过一个或多个价格方案销售,每个价格方案都有逐晚的价格与可订日历。把这四层理清,青旅的一张床、酒店的套房、三卧室的别墅,都能适配同一套搜索和结账流程。

各供应商对这些层级的叫法不同,有的还把其中两层合并,但这个结构始终存在。酒店把每个来源都映射到这一结构,客人看到的是统一的页面。

逐晚管理

可订日历决定住宿能否成交

每个住宿API最终都落到日历上。只有所请求住宿期间的每一晚都可订、有定价且符合入住规则时,搜索才会返回该房源。

两居室公寓 · 标准价格11月 2026 · 每晚价格
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • 可订,按晚定价
  • 已被预订
  • 房东已关闭
  • 从该入住日起的最少入住晚数
  • 不可入住

示意数据,已简化

  • 价格按晚计算住宿总价是每一晚的总和,因此按周末价的周五和周六,比两个工作日更贵。分日和分季节的价格存放在日历上,而不是房源上。
  • 最少入住晚数规则周五入住要求至少三晚时,两晚的搜索就不会显示该单元。租赁比酒店更常用这类规则,周末和旺季往往更严格。
  • 不可入住或不可退房某一晚可以作为较长住宿的一部分预订,但不能作为第一晚或最后一晚。度假屋的换客日就是这样运作的。
  • 关闭日期与停售房东会为自住或维修关闭日期,停售则立即让单元下架。所请求日期内只要有一晚关闭,该单元就会从结果中移除。

住宿不只是酒店

酒店、公寓与度假租赁的区别

数据模型是共通的,但不同类型的住宿填充方式不同。当您销售的不只是酒店客房时,预订流程需要处理这些差异。

酒店

包括青年旅舍和民宿

预订对象
有许多相同客房的房型,或共享宿舍里的一张床。
定价
按客房和餐食安排的每晚价格,加人或加儿童可能改变价格。
入住规则
仅在高峰日期要求最少入住晚数,大多数夜晚可单晚预订。
费用与押金
城市税或旅游税,有时还有在酒店支付的度假村费。
到达
24小时或有人值守的前台,凭证上的入住时间就够了。
典型来源
床库(Bedbank)和批发商、直签合同、渠道管理系统。

服务式公寓

公寓式酒店和城市公寓

预订对象
一种单元类型,通常带厨房和独立卧室。
定价
按单元的每晚价格,长住有周价或月价。
入住规则
最少入住晚数很常见,长住占需求的很大一部分。
费用与押金
每次入住收取清洁费和可退还押金很常见。
到达
前台营业时间不一,晚到需要密码箱或密码。
典型来源
渠道管理系统、直签合同和部分批发商。

度假租赁

度假屋、别墅和木屋

预订对象
某一栋具体的房子,通常只有这一栋。
定价
整栋房子的每晚价格,超出基础人数后每位客人另加收费。
入住规则
最少入住晚数、固定换客日和不可入住日期是常态。
费用与押金
清洁费、可退还的损坏押金和当地税费,付款前逐项显示。
到达
入住说明、地址和联系方式在到达前发送,绝不放在公开页面上。
典型来源
房东和物业管理公司,直接对接或通过渠道管理系统。

销售的是众多房东的房子,而不是自己签约的房源?那属于平台模式,详见BnB 门户页面。

取消政策期限

一笔预订,三个取消期限

取消政策是从入住日倒推的时间线。每个期限规定了客人在该期限内取消时能拿回多少。

预订入住
  1. 01 · 入住前14天之前免费取消客人取消后全额退款。这是旅客最先查看的截止时间,请显示为具体日期,而不是一条规则。
  2. 02 · 入住前14天至3天部分扣款会收取违约金,通常是首晚房费或住宿费用的一定比例。租赁在这个期限内可能扣留押金。
  3. 03 · 最后3天及未入住不可退款全额不退。以不可退款方式销售的价格方案,从预订那一刻起就处于这个期限。
示例期限;每个价格方案都有各自的设置。
  • 按价格方案,而非按房源同一套公寓可以同时有灵活价格和更便宜的不可退款价格,所以取消政策属于价格方案这一层。
  • 日期按房源所在地时区“提前14天”从房源所在地的入住日起算。请在页面和凭证上换算成明确的日期和时间。
  • 以供应商的政策为准使用API库存时,您不能提供比供应商更宽松的条款。使用自己签约的房源,则可以自行设置期限。

自有库存与API库存

您签约的房源和供应商API,同一次搜索

大多数住宿销售商两者兼顾:自己签约的房源自行录入,其余通过供应商API补充。旅客不应察觉某个住宿来自哪里。

您自己的房源

  • 在后台自行录入房源、单元和价格方案
  • 给房东和酒店提供Extranet登录,自行管理日历
  • 设置价格、最少入住晚数、关闭日期和取消期限
  • 带释放天数和停售功能的配额(Allotment)
  • 或从渠道管理系统接收价格和可订状态

供应商API库存

  • 覆盖您无法逐一签约的目的地的大型房源库
  • 搜索时获取实时价格与可订状态
  • 每个价格都带有供应商的餐食安排、政策和费用
  • 使用您自己的供应商合同和凭证启用
  • 预订和取消直接发送给供应商

客人得到什么

  • 一份结果列表,每个地点一个房源页面
  • 多个来源的同一间客房只显示一次,按您的价格展示
  • 按供应商、目的地或渠道设置加价,以及B2B代理价格
  • 无论由哪个来源确认,都是统一格式的凭证

渠道管理系统的对接详见渠道管理器集成。对于您签约持有的客房,请参阅预订库存系统。

PHPTRAVELS已就绪

已对接的住宿供应商

以下住宿供应商目前已对接Stays模块。您与供应商签约,在后台填入自己的凭证,在其沙盒环境测试后即可上线。名单实时来自我们的集成目录。

需要名单之外的供应商,比如区域性的租赁网络?只要有文档的住宿API都可以添加,详见定制API集成。酒店供应商类型与内容映射请阅读酒店API页面,两个最大床库的指南是RateHawk API对接和Hotelbeds API 集成。

像您的客人一样预订一次住宿

在在线演示中搜索、比价并预订,然后告诉我们您打算销售哪些房源和供应商。

在开发自己的应用或合作伙伴数据源?PHPTRAVELS REST API以统一格式提供所有已对接的住宿来源,并为预订事件提供Webhook。它包含在Enterprise套餐中,详见价格和开发者文档。更全面的介绍见旅游API。

常见问题

住宿API:开发者和代理商常问的问题

联系销售

住宿API是一组网络服务,让预订网站可以搜索住宿、读取指定日期和人数的价格与可订状态,并创建、查询和取消预订。它涵盖酒店以及其他所有类型的住宿:公寓、度假租赁、青年旅舍和民宿。

核心调用是一样的。住宿API还要处理非酒店住宿所需的内容:整套预订、最少入住晚数与换客日、加人收费、清洁费、可退还押金,以及到达前发送的入住说明。

可以。在PHPTRAVELS中,Stays模块对所有住宿类型使用同一个由房源、单元、价格方案和可订状态组成的模型,因此酒店、公寓和度假屋会带着各自的规则出现在同一次搜索中。

日历中的每一晚都可以设置最少入住时长,通常与入住日绑定。如果客人搜索的晚数少于最少要求,该单元就不会返回。不可入住和不可退房的标记对换客日也是同样的原理。

可以。您可以自行添加房源、单元、价格方案和日历,给房东提供Extranet登录,或从渠道管理系统获取价格,并与供应商库存一起在同一份结果列表中销售。

来自价格方案。供应商库存带有供应商的政策,您自己的房源则使用您设置的期限。截止时间会在付款前展示给客人,并印在凭证上。

不会。您需要与每个住宿供应商签约,并在后台填入自己的凭证。PHPTRAVELS提供预订平台、Stays模块和现成的连接器。

可以。在Enterprise套餐中,PHPTRAVELS REST API以统一格式开放所有已对接来源的搜索和预订,并提供预订事件Webhook和可供扩展的完整源代码。

一份PHPTRAVELS许可证、您自己的域名,以及至少一个库存来源:您自己签约的房源、渠道管理系统,或与住宿批发商的供应商合同。可以先通过在线演示了解完整流程。