扩大 Rapid Lodging API 的全球库存
扩大全球库存,参与全球竞争
Expedia 扩展的全球库存 (EGI) 可帮助您与全球 34,000 多家酒店竞争,并且会定期添加更多库存。这包括新采购的房产和当前采购的房产的额外库存。
技术细节
EGI 不是 Rapid API 中标准库存的一部分,但可以根据请求明确启用。它具有与标准库存不同的动态行为和集成模式,需要特别注意内容提取、购物和预订工作流程。
内容文件
EGI 的快速内容文件和目录文件 API 当前仅支持 English-language 内容。如果您的系统需要本地化(non-English)内容文件,您可以使用属性内容和地理 API 在本地生成它们。这些 API 为所有内容语言提供 real-time 流和灵活的数据处理,从而可以轻松地从 JSON-formatted API 响应中提取必要的信息。您可以在本地存储原始 JSON 响应以供稍后处理,或将其转换为数据库导入或其他用例。
使用地理 API 请求某个区域的属性列表的示例:
/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_ids使用 Property Content API 请求目录内容的示例:
/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalog您可以选择优先启动 EGI 的内容集成,同时分配额外的时间来审查购物和预订工作流程,或者当您为 EGI 做好准备时,可以同时启动所有三个组件。有关配置详细信息,请联系您的集成顾问。
房间数据对齐
在您的系统与 Property Content API 完全同步之前,新的房产房间可能会出现在 Shopping API 中。为了保持一致的用户体验,请考虑暂时将这些房间从客户显示中排除,触发新房间的 real-time 内容 API 调用,或增加本地内容更新的频率以最大限度地减少数据延迟。
速率标识符
EGI 费率的结构与标准库存不同,并遵循更动态的数据模型。由于这些费率没有静态值,因此购物 API 会返回与 Property Content API 中的值不对应的动态 rate_id值。此动态字符串值由数字、字母和各种其他符号组成,每个购物 API 响应中可能有所不同。因此,rate_id 值不稳定,不应用作持久标识符或主键。如果您的系统需要区分不同流程的费率,请考虑将它们与策略属性和报价特征的组合进行匹配。请参阅此安全文档以了解更多详细信息。
购物 API 响应中的 rate_id 值示例:
[
{
"property_id": "ABC152",
"status": "available",
"rooms": [
{
"id": "XYZ652",
"room_name": " Deluxe Double ",
"rates": [
{
"id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
… …床位配置变化
在特殊情况下,某些房间可能没有指定的床位配置,内容和购物 API 中均通过 bed_groupsID 0 和描述“未指定床位”来指示。这意味着酒店将根据 check-in 确定床位安排。虽然这种情况很少见,但您的系统应该让客户了解情况,如果他们有强烈的偏好,则协助他们将特殊要求传达给我们的客户运营团队。
购物 API 响应中未指定的床位配置示例:
{
"bed_groups": {
"0": {
"id": "0",
"description": "Bed Not Specified",
"links": {
"price_check": {
… …保持和继续
某些 EGI 费率与预订 API 保留和恢复工作流程不兼容,如果尝试保留,将会返回错误。为了防止糟糕的客户体验,您可以在购物 API 响应中请求可持有费率标志,并按照它来应用正确的工作流程。
请求可持有利率标志的示例:
Request:
/properties/availability?... …&include=rooms.rates.holdable
Response:
… …
"rooms": [
{
"id": "XYZ652",
"room_name": "Deluxe Double Room",
"rates": [
{
"id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
“holdable”: true,
… …Post-booking 功能
通过预订 API 确认预订后,预订信息将在管理预订 API 中提供。用于访问 post-booking 功能(包括软更改、硬更改和属性消息中心)的令牌链接也将在管理预订 API 中提供。有时,令牌链接可能需要长达五分钟才能准备好。值得注意的是,这些功能并非适用于所有预订,应在您的系统内妥善管理。
EGI 的主要区别
| 特征/行为 | 标准库存 | 扩大全球库存 |
|---|---|---|
| 默认可用性 | 默认启用 | 根据要求激活 |
| 速率标识符 | 静态、持久 | 动态,因商店而异 |
| 内容解决方案 | 兼容文件 API 和流内容 API | 兼容英语内容的文件 API 和所有语言的流媒体内容 API |
| 内容同步要求 | 每日同步热门房源 | 每日同步热门房源 |
| 床型配置 | 指定的 | 在极少数情况下可能未指定 |
| 保持和继续 | 适用于所有预订 | 部分预订可用 |
| Post-booking 功能 | 适用于所有预订 | 部分预订可用 |