Hotelbeds API集成：一流床位银行的实践经验

在不断发展的旅游业环境中，全球住宿供应商的无缝整合至关重要。OTA、酒店预订平台和其他旅游企业需要实时访问大量的酒店库存，以便为客户提供多样化的选择。Hotelbeds 是一家领先的住宿批发商，提供这种广泛的库存和先进的技术解决方案，使其成为许多人的首选。

本文深入探讨了 Hotelbeds 的核心、其产品和分步指南，包括我们使用其 API 的经验。

什么是 Hotelbeds：需要了解的关键事项

Hotelbeds 是酒店业最大的床位银行，在全球范围内提供广泛的住宿和其他旅行产品。作为床位银行，它在 B2B 领域运营，以折扣价从住宿提供商处批量采购房间，然后将其提供给 OTA、旅行社和航空公司等各种企业。

通过战略收购 Tourico Holidays 和 GTA 批发商，Hotelbeds 扩大了其投资组合，涵盖 200 个目的地国家的 300,000 多家酒店。具体来说，美洲大约有 85,000 家酒店，欧洲和中东有近 143,500 家，亚太地区约有 71,500 家住宿。

对于酒店经营者来说，Hotelbeds 是通往全球 150 多个客源市场的 71,000 多名旅游买家的庞大网络的桥梁。

在 AltexSoft，我们在多个项目中与 Hotelbeds 的 API 合作，在此过程中吸收了洞察力和专业知识。这些专业知识的范围从与 API 的直接交互到利用第三方提供商，为我们提供了关于集成可能性的广阔视角。在本指南中，我们将分享我们关于这个问题的主要发现。

膳宿

Hotelbeds 提供从传统酒店到替代住宿的各种库存产品。无论有人在寻找豪华体验、适合家庭的环境还是经济型住宿，他们都可以找到一个合适的地方，因为范围包括一切

• 酒店
• 度假村
• 精品酒店，
• 旅馆，
• 公寓
• 住宅/别墅，
• B&Bs，以及
• 公寓式酒店。

此外，酒店简介也被标记，使选择过程更加人性化。这些标签，例如“最适合海滩”或“豪华”，可引导用户找到最适合他们偏好的选项。例如，采购库存的经销商可以直接寻找带有“最适合观光”标签的酒店。

带有标签的酒店描述，以帮助代理商进行选择。来源： Hotelbeds

此外，Hotelbeds 与几个大型酒店品牌建立了合作伙伴关系，巩固了其在酒店业的地位。其中一些知名品牌包括IHG, Hilton, Sheraton, and Hyatt.

其他旅行库存

了解旅行者寻求的不仅仅是住宿，Hotelbeds 提供广泛的“Beyond the bed”投资组合。

• 旅游和景点：18,000+活动，覆盖200个国家的680个目的地。从城市观光随上随下巴士之旅等标志性体验到乐高乐园温莎度假村等景点，产品种类繁多。
• 接送：通过24,000种私人和共享接送选项确保无缝通勤。
• 租车：与170多个国家的500+供应商合作，包括Goldcar和Hertz等知名品牌。

连接解决方案

Hotelbeds 提供 APItude，这是一套专为酒店分销领域的连接而设计的应用程序编程接口 （API）。

该套件可即时访问约 250,000 家酒店的网络。APItude Hotel API 套件旨在为 Hotelbeds Group 客户提供服务，包含一系列 RESTful API，用于将 Hotelbeds 库存集成到旅游项目中。

APItude 的主要用例包括：

• 平台开发：适用于集成酒店网站和移动应用程序，确保内容实时更新。
• 集成功能：促进与组织内部的各种平台以及外部与其他服务的集成。
• 内容整合：使用户能够将住宿数据集中到一个单一的内容管理系统 （CMS） 中，这可能会简化产品管理和分发流程。

Hotelbeds 还与其他连接解决方案提供商合作，例如 SiteMinder、e-GDS 和 HotelRunner。这些合作伙伴关系旨在保持 Hotelbeds 数据的时效性和全面性。Hotelbeds 还提供满足活动和接送服务的 API。那些不寻求直接 API 集成的人可以使用网站预订、小部件和白标解决方案等替代方法。

Hotelbeds APItude 的核心组件和功能

APItude 是 Hotelbeds 的主要 API 套件，提供一系列旨在满足酒店分销和管理需求的功能。

该套件包含用于酒店、活动和接送的三个主要 API：

• Booking API用于管理预订数据和酒店预订流程，处理各种活动的预订和预订，并监督与转移预订相关的数据和流程
• Content API，用于提供与酒店相关的静态和动态信息，提供有关不同活动的详细信息，并提供有关可用转移选项的数据
• Cache API ，用于呈现酒店、活动和接送的定价和可用性快照，专门针对高流量平台进行了优化

随着本节的深入，我们将更深入地研究每个 API，重点介绍它们的独特功能以及它们如何满足各自行业的需求。

APItude 酒店 API

酒店预订 API。Hotel Booking API 是 Hotelbeds API 框架中的核心组件。此 API 包含整个预订工作流程，可实现实时酒店预订，通常只需两步。其功能范围从生成酒店列表和确认预订到管理取消和修改以及检索详细的预订信息。

该 API 用途广泛，尤其是与酒店内容 API 结合使用时，可以获取酒店内容数据。这种协同作用提供了丰富的细节，如图像、描述、设施等，使每个住宿都能得到全面的了解。

预定 API 的方法

酒店预订 API 包括以下方法。

• /hotels：主要用于房间可用性查询。此方法提供高级过滤器和灵活的日期搜索选项。该 API 提供了一个全面的酒店列表，详细说明了房间类型、董事会变化和房价列表。此外，它还包括所有财务信息——价格是决定性的，没有隐藏费用，并且清楚地显示了可能的取消费用。
• /checkrates：虽然大多数酒店都提供两步预订，但某些酒店需要更新当前的可用性和定价。这种方法授予了这一点，另外还显示向上销售选项，区分了请求的费率和所呈现的向上销售率的差异。
• /bookings:一种满足各种需求的多方面方法，包括确认预订、检索所有预订列表、获取特定预订详细信息、修改现有预订、处理预订取消或模拟预订取消条款。

在 APItude Hotel 套件领域，通过 HTTPS 协议促进数据交互，包括 POST、GET、PUT 和 DELETE 请求。支持 XML 和 JSON 格式，但由于其标准化结构，JSON 是首选。这种灵活性确保了无缝的请求构建和响应解析，并利用了许多流行编程语言中可用的工具。

Hotel Content API.  Hotel Content API. 用作静态酒店数据的存储库，补充了酒店预订 API 提供的动态信息。要理解 APItude 获取的内容，需要将其分类为两个主要分支：

• 静态信息是指与预订程序没有直接关联的数据。它包括评论、描述、照明性酒店图片和位置详细信息。
• 动态信息与预订操作直接相关;此数据更具流动性，代表实时变化。示例包括价格、特定日期的可用性、取消政策和相关费用。

用户通过结合静态和动态信息，获得酒店产品的全面视角。这确保了所有细节，无论是永久性的还是波动的，对用户来说都是显而易见的。

Hotel Cache API. Hotelbeds 的 Cache API 满足寻求广泛数据访问的用户和企业的需求，非常适合第三方平台上传或旅行套餐创建。

该系统提供对Hotelbeds数据库的访问，使您可以：

• 按需查看更新的价格和库存详细信息，
• 开发动态包装内容，
• 提供准确的产品，
• 在您的网站上展示预先计算的即时可用性，以及
• 管理您的库存缓存。

利用 Cache API 使企业能够扩大其影响力，并确保他们使用 Hotelbeds 的最新数据保持更新，从而增强用户体验和信心。

APItude activities APIs

Hotelbeds 还扩展了其 APItude 套件，以包含与活动预订相关的功能。此增强功能使用户能够在各种平台（包括台式机、移动设备和平板电脑）上检查门票和短途旅行的可用性。

用于活动的 Hotelbeds API 套件包括活动预订 API、活动内容 API 和活动缓存 API。

Activities Booking API 监督活动的实时列表，根据用户定义的过滤器调整输出。除了单纯的列表之外，它还确保用户获得特定活动代码及其各自运营日期的准确可用性数据。一旦到达预订阶段，此 API 就变得不可或缺。它掌控着几个关键流程：从确认预订到处理修改和取消。

Activities Contents API 提供辅助数据，包括国家/地区和目的地等地理方面。此外，当用户寻求有关活动的详细信息时，此 API 会提供全面的信息。从捕捉活动本质的生动图像到提供深度的商业描述，Contents API 确保活动的每个方面都得到照亮。

Activities Cache API 提供当前情况的简洁快照，详细说明价格、模式和运营日期范围。这确保了用户始终掌握实时产品的脉搏。

APItude 传输 API

APItude 的套件包含传输功能，满足通过网站和移动设备访问服务的用户的需求。此 API 为传输服务提供实时可用性，旨在促进跨平台的全面集成。

Transfer Booking API 涵盖了完整的Transfer Booking Trackary。它通过“可用性”、“简单”和“多个可用性”等类别提供实时可用性。此 API 可用于在决定接送时确认预订。预订后阶段同样简化，提供取消选项、获取预订详细信息，甚至访问全面的预订列表。

API 接受多种代码类型以满足不同的偏好。其中包括用于标准机场代码的 IATA、用于 Hotelbeds 的自定义酒店代码的 ATLAS 以及带有必要地址描述的 GPS 坐标。虽然建议使用多个选项，但由于映射不完整，因此不太建议使用 GIATA。

Transfers CACHEAPI通过允许下载与转账相关的内容和投资组合，进一步增强了该套件。它提供了从路线到上车点的转移操作的完整视图。此 API 专为离线访问而设计，提供详尽的列表，包括路线组合、酒店、货币信息等。

现在您已经了解有关 Hotelbeds API 产品的所有关键信息，我们将分解它们的集成过程。

如何与 Hotelbeds API 集成

本部分将指导您与 Hotelbeds API 集成。从技术要求到实时部署，了解如何确保使用 Hotelbeds 获得无缝的用户体验。让我们开始吧。

融入前评估

在启动 Hotelbeds API 集成之前，有必要进行全面的准备评估。

定义需求。首先制定对您的平台至关重要的特定 Hotelbeds 服务。无论是酒店预订、活动预订还是转机，确定您的需求将决定您将参与的精确 API 端点和服务。

技术准备。 鉴于 Java、Python 或 PHP 等编程语言在 API 集成中的广泛使用，集成过程需要对它们有深入的理解。领导集成的个人或团队应精通处理 API、解释全面的文档以及解决潜在问题。

文档。熟悉 Hotelbeds API 文档对于获得不间断的集成体验至关重要。此路线图指导用户了解最佳实践以及如何规避潜在问题。

回顾我们的经验，AltexSoft 的解决方案架构师 Oleksandr Gerashchenko 评论道：“我真正欣赏 Hotelbeds 文档的一点是它的清晰和彻底。它简洁明了，但涵盖了您需要的一切。

在进行了彻底的集成前评估之后，是时候深入研究集成的复杂细节了。

集成设置

开始与 Hotelbeds 的 APItude 的集成之旅需要对初始设置和开发路径有深入的理解。这里有一张地图，可以确保你在这次探险中精确导航。

注册和 API 密钥获取。 首要任务是注册。通过注册，您开始了与 APItude 的集成之旅。

在 Hotelbeds 注册免费 API 密钥。

这个简单的注册过程会授予您 Hotelbeds 的三个 API 套件的 ID 和 API 密钥：酒店、活动和接送。这个典型的 API 密钥充当您向他们的 API 发出的每个请求的看门人。

凭据配置和身份验证。 注册后，您将拥有一组三个 API 密钥供您使用，每个密钥用于上述套件。

“我的 API 密钥”选项卡。

这些密钥可以通过您的个人仪表板访问。但是，仅仅拥有密钥是不够的，还需要适当的身份验证。这涉及发送 API 密钥和 X-Signature（十六进制格式的 SHA256 哈希）。此哈希值是由您的 API 密钥、密钥和当前时间戳（以秒为单位）组合而成的。

身份验证过程。

启动 API 请求以进行测试。 设置凭据并配置身份验证后，就可以开始测试阶段了。APItude 允许您针对其端点进行测试。

在AltexSoft的测试项目中，Oleksandr Gerashchenko指出：“搜索酒店从位置和日期开始。搜索将返回缓存的结果。它可能会以大致价格显示特定的酒店和房间。但是一旦你进入一个特定的酒店，它就会返回有关房间和价格的更详细的信息。

Oleksandr 还提到了我们的团队在区分生产模式和沙盒模式方面面临的挑战，尤其是沙盒每天只能查询 50 次的限制。然而，值得注意的是，这些测试服务器反映了它们的生产对应项。针对此测试服务器的任何预订请求都不会以实际预订或信用卡费用告终。您可以考虑利用他们的 Swagger 规范或 Postman 集合来满足您的首次请求。

严格遵循这些步骤可确保您的集成过程打下坚实的基础。后续阶段涉及进一步开发、优化和最终部署到您的系统中。

认证：让您的集成栩栩如生

确保您的 Hotelbeds 集成的质量和可靠性需要严格遵守他们的认证流程。该协议评估各种技术、功能和操作标准的集成，以保证无可挑剔的最终用户体验。

准备阶段。 准备阶段要求遵循最佳实践来简化认证。重点放在五个关键领域：

• 技术方面，
• 工作流，
• 带有 CheckRate 和 Confirmation 的可用性，
• 内容，以及
• 凭证发放和实时环境测试。

启动认证。在根据这些支柱完善您的集成后，下一步涉及联系 Hotelbeds.通过电子邮件 atapitude@hotelbeds.com 联系，详细说明您的工作流程、不同分销渠道的独特方法、商业选择、认证 URL 和其他相关数据。

技术和工作流程审查。为了探究具体细节，技术审查专门用于审查请求配置和 GZIP 压缩的功效。工作流段强调预订不可或缺的 API 调用的准确性和顺序。减少冗余和确保精度至关重要。

可用性、支票汇率 和确认。 系统必须准确反映基本可用性、支票汇率和确认信息。它应该便于选择乘客人数，确认儿童的存在和年龄，并处理多房间预订。此外，遵守使用不透明费率、来源市场、过滤器和取消政策显示等规定至关重要。

内容同步。 与 Hotelbeds 的 ContentAPI 进行内容同步是关键。捕获有关酒店的多样化数据可确保提供及时准确的酒店信息、图像、类别和设施。

凭证的发放。 一旦有确认的预订，系统应立即向最终用户发送优惠券。该文件作为预订确认，应列出从酒店详细信息到预订细节和付款指南的所有内容。

实时环境测试。 认证之旅的最后阶段围绕着实时环境测试展开。进行真实预订是为了验证和验证系统的有效性。这是一个双重测试，随后的取消是另一层确认。

确保在整个广泛的认证过程中符合规定，可以肯定您的集成的完整性和稳健性，并提升用户体验，使所有潜在客户都能无缝且无误地进行认证。

第三方集成注意事项

有时，可以使用聚合器服务简化与 Hotelbeds 的集成之旅。这些聚合器整合了多个 API，范围从床位银行（如 Hotelbeds）到其他服务提供商（如 Booking.com 或航空公司）。这种方法的一个明显优势是能够通过单一 API 接触到众多供应商。它节省了时间，减少了技术开销，并且消除了进行多项认证的需要。

与此同时，虽然技术集成变得更加顺畅，但企业仍然必须与他们希望访问其库存的每个终端供应商进行单独谈判。

AltexSoft 的交付经理 Olga Ladyk 回顾了一次这样的经历：“为我们的 Hotelbeds 集成选择第三方聚合器是一项战略举措。它通过避免某些认证步骤来快速跟踪我们的项目。此外，包括Hotelbeds的服务极大地丰富了该项目，我们收到了非常积极的反馈。

在考虑这条路线时，尤其是对于旅行经销商来说，了解其优势和挑战至关重要。每个聚合器都有自己的操作细微差别，虽然它们可能会与您的项目的技术堆栈保持一致并加速开发，但您必须为使用此类服务可能出现的独特挑战做好准备。

部署和管理

在向您的用户群展示 Hotelbeds 集成之前，请确定策略：选择分阶段向用户介绍，或同时向所有用户提供。部署后，始终如一地监控集成的执行情况，并直接从用户那里收集反馈，尤其是关于 Hotelbeds 提供的功能的反馈。整合应该是一个活生生的实体，随着时间的推移而发展。使用累积的性能数据和用户反馈作为路线图，对系统进行必要的改进和增强。

集成 Hotelbeds API：吸取的主要经验教训

与 Hotelbeds API 集成的过程提供了几个教训，其中许多教训只有在深入研究实际集成时才会变得明显。AltexSoft 的经验提供了这一过程的第一手资料，揭示了该过程的细微差别。

战略查询规划。 虽然沙盒环境是测试集成的安全空间，但明智地使用它至关重要，因为对过多的查询有限制。在提取和存储内容时采用战略性方法是可取的，以确保在保持潜在边界内的同时最大化检索到的信息。

对文档进行深入分析。任何整合之旅都需要一个指南针;对于 Hotelbeds API，这是他们的文档。奥列克桑德·格拉什琴科（Oleksandr Gerashchenko）的见解强调了其重要性。“阅读文档不仅仅是一个例行步骤;这是顺利整合的关键，“他分享道。“这不仅提供了一条途径，而且突出了潜在的陷阱，使过程更具可预测性。”

本地内容存储策略。 在本地存储内容，尤其是在处理像 Hotelbeds 这样的大型数据库时，是为了提高效率并确保为用户提供最新信息。Oleksandr Gerashchenko 说：“我们实施了一个单独的流程，定期访问 Hotelbeds 以提取内容。起初，我们提取了所有内容并将其存储在我们的数据库中。然后，我们每天检查一次任何内容更改，并且只提取这些更新。定期更新，而不是每次都查询数据库，可以使系统的响应速度更快，效率更高。

与任何其他 API 一样，与 Hotelbeds API 集成是理解该工具并将其与您的系统功能相结合的复杂舞蹈。通过上述经验教训和见解，您可以更好地准备并更有效地执行您的集成计划。

Hotelbeds的竞争对手和替代品

在酒店分销平台的竞争格局中，Hotelbeds 面临着来自几个主要参与者的激烈竞争。因此，您可以考虑以下批发商。

按住宿和连通性划分的 Hotelbeds 批发商竞争对手的比较。

Webjet 开发的 WebBeds

作为Webjet Limited旗下的一部分，WebBeds自2013年推出以来，已迅速发展成为全球第二大住宿供应商。他们在 170 多个国家/地区拥有超过 368,000 处房产的庞大库存。WebBeds 主要为旅行社、OTA 和旅游经营者提供服务，拥有多元化的区域品牌系列，例如 JacTravel DMC、Sunhotels、Destinations of the World （DOTW）、FIT Ruums、Lots of Hotels （LOH） 和 Umrah Holidays International （UHI）。

虽然住宿仍然是他们的核心优势，但他们也与全球 16,000 多家旅游相关服务提供商建立了联系。它们的集成能力因 WebBeds 系列中的特定品牌而异。

HPro Travel （HotelsPro）

HPro Travel（以前称为 HotelsPro）声称拥有最大的库存组合，提供 205 个国家/地区的 100 万家酒店的访问权限。他们主要扎根于欧洲，在全球扩张方面取得了长足的进步。他们的服务主要面向旅游经营者和旅行社，包括从经济型住宿到豪华度假村的各种住宿类型。

除住宿外，HPro Travel 还提供一系列辅助旅行服务，如机场接送、汽车租赁以及多样化的旅游和活动。他们强大的 JSON API 文档有助于无缝的第三方集成。

Bonotel

Bonotel Exclusive Travel 专注于豪华旅游领域，主要在美国、墨西哥和加勒比地区提供高档物业的利基投资组合。尽管他们的酒店库存相对较小，但他们以与米高梅国际度假村、四季酒店和丽思卡尔顿酒店等知名酒店品牌的独家合作而自豪。它们的集成功能通过 RESTful API 实现，并由 XML 消息传递提供支持，这有助于酒店预订并管理静态酒店内容。

与任何其他技术一样，最好检查所有可用选项以选择最适合您任务的选项。

原文来源：https://www.altexsoft.com/blog/hotelbeds-api-integration/