Developer Hub

变更日志

下面列出 Rapid API 中发生的所有变更，按发布月份分组。

|

2024 年 4 月

会员 - Book | Shop | Feature | V3

我们正在添加新功能，以帮助您更快速地查找商务房价，从而有机会获得与住宿会员计划相关的积分。了解有关酒店会员积分的更多信息。

好处：

合作伙伴将拥有更好的工具，帮助其商务旅客通过住宿会员计划获得积分。

2024 年 1 月

营销费用奖励 - Shop | Feature | V3

在选购请求为 include 参数添加了一个新值，这将导致在响应中返回 marketing_fee_incentives 对象。 对象。

Rapid 3 请求示例：

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only\
&include=rooms.rates.marketing_fee_incentives\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 响应示例：

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "marketing_fee_incentives": [
              {
                "source": "property",
                "start": "2024-01-01",
                "end": "2024-01-01"
              }
            ],
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

好处：

合作伙伴将能更轻松地识别出应用了特别奖励的房价。

2023 年 11 月

新的搜索和筛选选项 - Content | Feature | V3

我们添加了新的请求参数，使您能够通过以下字段缩小搜索结果的范围：

  • all_inclusive
  • amenity_id
  • attribute_id
  • category_id
  • spoken_language_id

此外，我们还可以通过增加 include 参数的有效值的数量，更精确地指定要包含响应的哪些部分。新的值包括内容响应的所有概要元素。请参见搜索和筛选了解更多信息。

Rapid 3 请求示例： 在此示例中，我们使用了新的 amenity_id 搜索参数，并在 include 参数中使用了 name 和 amenities 的新值。

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=name\
&include=amenities\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 响应示例： 在此响应中，我们可以看到只返回了住宿 1337，因为住宿 1 没有服务设施 id 115。我们还看到，property_id、name 和 amenities 都包含在响应中。 property_id 始终包含在响应中，无需指定为 include 请求参数，除非它是响应中唯一需要的字段。

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}

好处：

对于那些寻找更具体的住宿和更具体的响应字段的合作伙伴来说，他们现在可以优化其与 Rapid 内容 API 的互动。通过指定需要哪些内容，合作伙伴还可以让 Rapid 团队知晓他们会使用哪些内容，因此对合作伙伴很有价值。

移动端促销场景 - Shop | Feature | V3

在 include 参数中添加了 sale_scenario.mobile_promotion 值，用于房态和购买变更请求。

在房态、其他价格和购买变更回复中添加了 room.rate.sale_scenario.mobile_promotion 字段。

Rapid 3 请求示例：

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=mobile_app\
&sales_environment=hotel_only\
&include=sale_scenario.mobile_promotion\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 响应示例：

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "sale_scenario": {
              "package": false,
              "member": false,
              "corporate": false,
              "distribution": false,
              "mobile_promotion": false
            },
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

好处：

合作伙伴将拥有一种新的方法，更轻松地识别出与移动端促销相关联的房价。

新巴士站地区类型 - Geography | Feature | V3

将 bus_station 地区类型添加到 Regions 端点的请求中。Region 和 Regions 现在都将提供有关 bus_station 类型的地区的数据。

Rapid 3 请求示例：

curl -X GET "https://test.ean.com/v3/regions\
?include=standard\
&language=en-US\
&supply_source=expedia\
&type=bus_station" \
 -H "Accept: application/json" \
 -H "Authorization: EAN apikey=1234,signature=14140287ea6ea1396b18b,timestamp=1697826383" \
 -H "Accept: application/json" \
 -H "Accept-Encoding: gzip" \
 -H "User-Agent: TravelNow/3.30.112"

Rapid 3 响应示例：

[
  {
    "id": "11234754",
    "type": "bus_station",
    "name": "Port Authority Bus Terminal",
    "name_full": "Port Authority Bus Terminal",
    "country_code": "US"
  }
]

好处：

合作伙伴可以在其网站上为旅客提供巴士站信息。

2023 年 10 月

内容中的度假短租屋 IPM 名称 - Content | Feature | V3

为住宿内容响应添加了 vacation_rental_details.ipm_name 栏。

Rapid 3 响应示例：

{
  "4687248": {
    "property_id": "4687248",
    "name": "Beautiful 6 Bedroom Home With Two Pools, Only 10 minutes To Theme Park!",
    "address": { ... },
    ...
    "fees": {
      "traveler_service": "Your credit card statement will show two separate charges, one for the booking amount and property fees and another for the service fee. Both will be charged by Expedia partner Good Company.. The traveler service fee is refundable only when your entire booking is fully refundable. Please refer to the terms and conditions for the rules applicable to the booking facilitation services provided."
    },
    "attributes": { ... },
    ...
    "vacation_rental_details": {
      "private_host": true,
      ...
      "vrbo_srp_id": "334.3634257.3458973",
      "listing_id": "1252577",
      "listing_number": "3834275",
      "listing_source": "VRBO",
      "listing_unit": "/units/0001/429ecad2-bade-429a-a427-8adee57420ec",
      "ipm_name": "Good Company",
      "unit_configurations": { ... },
      "enhanced_house_rules": { ... },
      "free_text": "Stunning brand new 2-story home with 6 bedrooms, 4 bathrooms, brand new appliances/furniture, game room, grill, patio, and beautiful scenery all around. Minutes from Super Cool Lake. This place is the perfect getaway for a larger group whether it be a golf trip, lake trip, or time to gather with the family. Please note this property has two parking stalls, in addition to first come first serve overflow parking in the community. Celebrating something special? Birthday, Anniversary, Bachelor/Bachelorette, etc? We also offer decorating services for an extra fee. Please inquire within! This home features a fully-equipped kitchen for preparing meals, onsite washer and dryer and most importantly a private space, much larger than a hotel room for private family time away from crowds and people. We have a self-check-in and check-out system to limit your contact with people as well. THE BASICS: 6 bedrooms & 1 loft - 5 Kings, 2 Bunk beds , and 1 pull-out couch in the loft - Sleeps 16 people. 4 Bathrooms - Master (jetted tub, walk-in shower, double sinks), other 3 bathrooms (tub/shower combo & sink). Fully Equipped Kitchen. Open Main Room with plenty of seating. Dining Room table and bar stools around kitchen island area. Plenty of space to spread out and enjoy your friends/family. Free Wifi. THE EXPERIENCE IN DETAIL: -As you walk in the front door and are greeted by the open floor layout of our kitchen and great room you immediately breathe easy seeing that there is plenty of room here for you and your family. Our Kitchen is stocked with plenty of cookware and dishes so you can create a huge breakfast that will get everyone out of bed and ready for a day of fun. A potted coffee maker and a Keurig is available. You will need to bring your own coffee/pods/filters/creamer etc. Cozy up in the living room for a late night movie on our large flat-screen TV equipped for your viewing pleasure. Our luxury Master bedroom with it’s King size bed, premium bedding, and TV invite you and your spouse to relax together and feel a little spoiled. This is a vacation after all! Enjoy our Master Bath with it’s jetted tub, walk-in shower, and double sinks. Explore the Upstairs which has 4 Bedrooms - 3 furnished with a King size bed, premium bedding, 1 is the bunk room which is equipped with 4 twin size beds. This home is not handicapped accessible!!!"
    },
    "supply_source": "Vrbo",
    "spoken_languages": { ... }
  }
}

好处：

销售 Vrbo 供应产品的合作伙伴需要 IPM 名称，以便向住客发消息，告知他们将从他们的银行卡中扣款和/或向他们发送确认邮件的 IPM 名称。目前，此信息仅作为 fees.traveler_service 内容的一部分以段落形式提供。

检索中的营销费用 - Manage Booking | Feature | V3

将检索 room.rate.pricing.totals.marketing_fee 时的预估值添加到检索响应中。

Rapid 3 响应示例：

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "rooms": [
    {
      "id": "926784314",
      "confirmation_id": { ... },
      ...
      "status": "booked",
      ...
      "rate": {
        "id": "035943984",
        "merchant_of_record": "expedia",
        ...
        "pricing": {
          "nightly": [ ... ],
          "stay": [ ... ],
          "totals": {
            "inclusive": { ... },
            "exclusive": { ... },
            "marketing_fee": {
              "billable_currency": {
                "value": "7.75",
                "currency": "USD"
              }
            },
            "property_fees": { ... }
          },
          "fees": { ... }
        }
      },
      "links": { ... }
    }
  ],
  "billing_contact": { ... },
  ...
}

好处：

对订单进行硬性变更后，合作伙伴将能够看到 marketing_fee 的更新值。

2023 年 9 月

检索旅行目的 - Manage Booking | Feature | V3

将 travel_purpose 的存储值添加到检索响应中。

Rapid 3 响应示例：

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "conversations": {...}
  "travel_purpose": "leisure",
  "trader_information": {...}
}

好处：

合作伙伴将能够查看向住宿方传达的值，以确定旅客的旅行目的是商务旅行还是休闲旅行。

2023 年 7 月

下线的住宿 - Content | Feature | V3

添加了下线的住宿的端点。

Rapid 3 请求示例：

https://test.ean.com/v3/properties/inactive?since=2023-07-12

Rapid 3 响应示例：

[
  {
    "property_id": "15316"
  },
  {
    "property_id": "15362666"
  },
  {
    "property_id": "15462554"
  },
  {
    "property_id": "1614382"
  },
  {
    "property_id": "18762476"
  }
]

好处：

合作伙伴将能够快速轻松地从其缓存内容中删除住宿，并知道不再向哪些住宿发送房态请求。

旅行目的指示符 - Shop | Feature | V3

为房态请求添加了 travel_purpose 参数。

Rapid 3 请求示例：

为房态请求添加了新参数：

travel_purpose=business

好处：

合作伙伴将能够了解旅客的旅行目的是商务旅行还是休闲旅行。

不可预订的原因 - Shop | Feature | V3

为房态请求添加了 include 参数，其值为 unavailable_reason，以请求响应包含相关住宿的条目，这些住宿未返回房价但包含相应的原因，便于您采取行动。

Rapid 3 请求示例：

为房态请求添加了新参数：

include=unavailable_reason

好处：

合作伙伴将能够在选购结果中包含有关该住宿不可预订原因的信息。

服务设施类别搜索 - Shop | Feature | V3

为房态请求添加了 amenity_category 参数。

Rapid 3 请求示例：

为房态请求添加了新参数：

amenity_category=wifi

好处：

合作伙伴将能够搜索包含具有匹配类别的服务设施的价格。

包含突破性定价 - Shop | Feature | V3

添加了 inclusive_strikethrough 的定价信息。

Rapid 3 响应示例：

[
  {
    "property_id": "19248",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            ...
            "occupancy_pricing": {
              "2": {
                "nightly": [ ... ],
                "stay": [ ... ],
                "totals": {
                  "inclusive": { ... },
                  "exclusive": { ... },
                  "inclusive_strikethrough": {
                    "billable_currency": {
                      "value": "726.63",
                      "currency": "CAD"
                    },
                    "request_currency": {
                      "value": "549.60",
                      "currency": "USD"
                    }
                  },
                  "strikethrough": { ... },
                  "marketing_fee": { ... },
                  "gross_profit": { ... },
                  "minimum_selling_price": { ... },
                  "property_fees": { ... }
                },
                "fees": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

好处：

合作伙伴将能够通过酒店提供的折扣（包括税费）节省相关费用。

2023 年 6 月

硬性变更 - Book | Feature | V3

为 Rapid 添加了新的硬性变更端点和流程。

好处

合作伙伴现在可以通过 Rapid API 代表其旅行客户修改预订。

有关更多详细信息，请参阅硬性变更。

行程历史记录 - Book | Feature | V3

为行程搜索和行程检索调用添加了行程历史信息。

好处

作为行程搜索或行程检索的一部分，合作伙伴现在可以检索与创建、硬性变更和取消相关的行程历史记录详细信息。

请参阅行程历史记录了解更多信息。

2023 年 4 月

VRBO 房东自由文本描述 - Content | Feature | V3

为住宿内容响应的 vacation_rental_details 部分添加了 free_text 。

Rapid 3 模式示例：

{
  "12345": {
    "property_id": "12345",
    "name": "Test Property Name",
    "phone": "1-417-862-0153",
    "vacation_rental_details": {
      "free_text": "Free form description and explanation of property provided by the host.Can possibly contain html break tags.",
      "listing_id": "1237874"
    }
  }
}

注意：示例并没有展示住宿内容响应的全部内容

好处

合作伙伴将能够展示由房东提供的度假短租住宿的更多信息。

请参考 Vrbo on Rapid 集成指南

多个地区搜索增强功能 - Geography | Feature | V3

添加了几个新的搜索参数：

  • area 使用半径和坐标（纬度/经度对）或地区 ID 来定义一个区域
  • limit 限制返回结果的数量
  • country_subdivision_code 返回与 ISO 3166-2 国家/地区细分代码相匹配的结果

在 Regions 和 Region 响应中添加了 country_subdivision_code

好处

合作伙伴将能够选择与指定区域存在交集的多个地区。

搜索指定纬度/经度 50 公里内的机场：

type=airport&limit=3&area=50,37.227924,93.310036

OpenAPI 规范的改进 - Update | V3

对 OpenAPI 规范进行了多种不同的改进：

  • 为日期加了引号，以便它们能在 API Explorer 中正确呈现。
  • 再次对限定多边形进行了调整，以提高与 Java 客户端生成代码的兼容性
  • 改进了引用 ISO 标准时的一致性（如ISO 639-1 alpha-2 和 ISO 3166-1 alpha-2）

这一变更并不会影响 API 的功能，只是改进了 OpenAPI 规范。

好处

使用下载的 OpenAPI 规范 yaml 文件，增强了 API Explorer 中的功能，并提高了与合作伙伴的兼容性。

2023 年 1 月

排除了含可退款损坏押金的房价 -Shop |Feature | V3

为房态请求添加了 exclusion 参数。

Rapid 3 请求示例：

为选购请求增加了新参数：

exclusion=refundable_damage_deposit

好处：

合作伙伴将能够指定响应中应不包括含可退款损坏押金的房价。

明确了地理位置多边形和示例 -Geography |Update | V3

该规范中关于坐标请求和响应中的多边形格式的详细信息不准确。相关示例已经更新，可以在地理位置端点的 API Explorer 中使用。

这一变更并不会影响 API 的功能，只是修正了 OpenAPI 规范。

Rapid 3 模式示例：

这是一个节选的 regions 响应的示例：

"coordinates": {
      "center_longitude": -93.29277,
      "center_latitude": 37.207935,
      "bounding_polygon": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -93.298931,
              37.205162
            ],
            [
              -93.28672,
              37.205299
            ],
            [
              -93.286549,
              37.21005
            ],
            [
              -93.286763,
              37.210221
            ],
            [
              -93.298931,
              37.205162
            ]
          ]
        ]
      }
    },

好处：

该规范现在准确地反映了 regions 响应可以同时返回 Polygon 和 MultiPolygon 对象。它还为多边形搜索提供了准确的模式和示例。

2022 年 12 月

Vrbo 房态日历 - Shop | Feature | V3

添加了 Vrbo 房态日历端点“/calendars/availability”。

Rapid 3 模式示例：

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

好处：

Rapid 房态日历 API 提供指定住宿一段时间内的每日房态摘要，可用于为查看住宿详细信息页面的住客提供帮助。

您可以在此处查看更多详细信息。

优化了租房规定 -Content |Feature | V3

在针对 Vrbo 住宿的 Rapid 内容 API 中，添加了优化的租房规定，取代了之前的租房规定。

Rapid 3 模式示例：

"enhanced_house_rules": {
        "CheckIn": {
            "rule": "Check in after 3:00 PM",
            "additional_information": []
        },
        "CheckOut": {
            "rule": "Check out before 11:00 AM",
            "additional_information": []
        },
        "Occupancy": {
            "rule": "Maximum overnight guests: 5 (sleeps up to 5 adults)",
            "additional_information": []
        },
        "MinBookingAge": {
            "rule": "Minimum age to rent: 18",
            "additional_information": []
        },
        "Children": {
            "rule": "Children allowed: ages 0-17",
            "additional_information": []
        },
        "Pets": {
            "rule": "Pets allowed: 1 pet less than 10kgs",
            "additional_information": [
                "Pets allowed under aproval/Se requiere aprobacion"
            ]
        },
        "Events": {
            "rule": "No Events allowed",
            "additional_information": []
        },
        "Smoking": {
            "rule": "Smoking allowed: outside",
            "additional_information": [
                "Silence is required after 10pm/Silencio 10pm",
                "At the balcony, Thank you! En el balcon, Gracias!"
            ]
        }
    }

好处：

优化的租房规定能够更清晰地显示住宿政策，包括房东自行添加的文本说明，从而能够描述每个政策的限制/例外情况或与住客住宿有关的其他信息。

地理位置增强功能 -Geography |Feature | V3

地理位置调用现在具有以下增强功能：

  • 在 Polygon 请求中为 Region、Regions 和 Properties 增加了 supply_source 筛选条件。
  • 在 Polygon 响应中为 Region、Regions 和 Properties 增加了 Pagination-Total-Results 标头。
  • 为 Regions 请求增加了 type 和 country_code 筛选条件。

好处：

各种地理位置调用现在具有了这些增强功能，合作伙伴能够更精确地控制他们收到的结果。

2022 年 11 月

添加了不可退款日期范围 - Shop| Manage Booking Feature | V3``

为房态和行程响应添加了不可退款的日期范围对象。

Rapid 3 模式示例：

"nonrefundable_date_ranges": [
    {
    "start": "2022-09-05",
    "end": "2022-09-11"
    }
   ],

好处：

合作伙伴将能够显示供应商根据假期或其他因素设定的退款例外情况，因此旅客能够更好地了解他们取消预订后何时会收到退款。

在 Region 响应中添加了类别列表和标签列表 -Geography |Feature | V3

为所有 Region 响应添加了类别列表和标签列表。

Rapid 3 模式示例：

"categories": [
    "tourism:region"
],
"tags": [
    "geoAdmin:city"
]

好处：

合作伙伴将能够利用类别和标签来获得有关返回 region 响应的元数据信息。

Rapid 2.3 版和 2.4 版已停用 -Remove |V2.4 | Breaking Change

Rapid API 2.3 版和 2.4 版现已停用。

2022 年 10 月

在内容中添加了 Vrbo 的单元配置 -Content |Feature | V3

在内容响应中添加了单元配置对象。

Rapid 3 模式示例：

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

好处：

单元配置介绍了客房内的床型以及每种床型的数量。

2022 年 7 月

添加了中文（香港）语言 - Content | Shopping | Feature | V3

添加了中文（香港）语言选项。现在可以在支持语言参数的请求中使用“zh-HK”语言代码。

可访问此处，查看所有受支持语言的列表。

Vrbo 基本住宿信息 - Manage Booking | Feature | V3

在行程响应中添加了 Vrbo 基本住宿信息。

Rapid 3 模式示例：

"essential_information": {
  "contact": {
    "name": "John test",
    "phone": {
      "country_code": "1",
      "area_code": "367",
      "phone_number": "6876876"
    },
    "email": "dv@devmail.wvrgroup.internal",
    "address": {
      "line_1": "3rd St",
      "line_2": "421 W",
      "city": "Austin",
      "state_province_code": "TX",
      "postal_code": "86868",
      "country_code": "US"
    }
  },
  "essentials": [
    {
      "name": "directions",
      "instructions": "30.3079827,-97.8934852\n\nTurn right into the alley at the end of the road.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/a94d96e2-499b-4155-8872-6d0a4dd9a9db.large.jpg",
          "width": 1024,
          "height": 768
        },
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/e1713ff4-ad67-4498-93a1-befbdf5275a0.large.jpg",
          "width": 1024,
          "height": 768
        }
      ]
    },
    {
      "name": "wifi",
      "instructions": "Secure, hi speed wifi is available throughout the property.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/caa47f61-3e7f-459b-bd74-e3cfe76a0edc.large.jpg",
          "width": 1024,
          "height": 768
        }
      ],
      "additional_info": {
        "network_name": "HomeNetwork",
        "network_password": "HomeNetwork1234567890"
      }
    },
    {
      "name": "thermostat",
      "instructions": "Thermostat\n\nDo not adjust thermostat below 59F/15C."
    }
  ],
  "updates_available_datetime": "2022-08-14T09:00:00-05:00"
}

好处：

Vrbo 基本住宿内容为旅客提供重要的到达前说明，包括住宿地址和物业经理的联系信息。其中还可以包含旅客在到达时、住宿期间或离店时可能需要的其他关键详情。

2022 年 5 月

适用于所有版本的消费者新政 (ND4C) 监管变化 -Shopping | Booking |Manage Booking |Feature |V3 | Breaking Change

我们在 Rapid 中进行了变更，以应对“消费者新政”(ND4C) 法规对您业务的影响。该法律将影响欧盟和英国的销售网站。

Rapid 3 模式示例：

"trader_information": {
  "traders":[
    {
       "name": "Expedia",
       "address": {
         "line_1": "555 1st St",
         "line_2": "10th Floor",
         "line_3": "Unit 12",
         "city": "Seattle",
         "state_province_code": "WA",
         "postal_code": "98121",
         "country_code": "US"
       },
      "email": "travel@support.expedia.com",
      "phone": "0330-123-1235",
      "contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business or profession."
     }
   ],
   "terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}

好处：

向合作伙伴提供交易者信息，以符合 ND4C 的监管要求。

不再提供克罗地亚语和立陶宛语 - Content |Shopping |Remove | V3

克罗地亚语和立陶宛语已不再提供。如果请求接受语言参数，那么将这些语言传递至请求中的尝试导致出现错误。

2022 年 4 月

Rapid 2.3 版和 2.4 版已弃用 - Deprecated | V2.4 | Breaking Change

Rapid API 2.3 版和 2.4 版现已弃用。这两个版本将于 2022 年 10 月停止使用。

Rapid 2.2 版已停用 - Remove | V2.2 | Breaking Change

Rapid API 2.2 版现已停用。

2021 年 9 月

向通知测试 API 添加了请求正文 - Notifications | Change | V3 | Breaking Change

现在需要请求正文。

Rapid 3 模式示例：

{
    "event_type": "itinerary.agent.create"
}

好处：

确保 Rapid API 整体的一致性。

向通知无法送达 API 添加了无法送达参数 - Notifications | Change | V3 | Breaking Change

现在需要一个新的无法送达查询参数。

好处：

确保 Rapid API 整体的一致性。

移动了可退款损坏押金和预留卡限额字段以与 Shop 保持一致 - Manage Booking | Change | V3 | Breaking Change

移动了可退款损坏押金和预留卡限额字段，以与 Shop 保持一致。

Rapid 3 模式示例：

"card_on_file_limit": {
  "value": "string",
  "currency": "string"
},
"refundable_damage_deposit": {
  "value": "string",
  "currency": "string"
},

好处：

这为合作伙伴简化了模式。

通知 API 端点变更 - Notifications | Change | V3 | Breaking Change

通知测试 API 和通知无法送达 API 的端点已变更（删除了后面的 /{event_type} 和 /undeliverable）。通知测试 API 的端点从 GET 变更为 POST。

好处：

确保 Rapid API 整体的一致性。

重命名了“押金政策”，改为“押金”以与 Shop 保持一致 - Manage Booking | Change | V3 | Breaking Change

将押金政策对象重命名为押金，以与 Shop 保持一致。

Rapid 2.4 模式示例：

"deposit_policies": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

Rapid 3 模式示例：

"deposits": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

好处：

这为合作伙伴简化了模式。

TripAdvisor 内容 API 端点已弃用 - Content | Deprecate | V3 | Breaking Change

Expedia Group 不再与 TripAdvisor 维持合作关系，因此 Rapid 3 中的 TripAdvisor 内容 API 端点将弃用。

好处：

合作伙伴将无法调用冗余端点。

添加了会员 ID - Booking | Manage Booking | Feature | V3 | Breaking Change

这是一项新功能，使合作伙伴能够提供酒店会员 ID

  • 与此客房住客关联的酒店会员计划的指示符。
  • 在 rooms 对象下

Rapid 3 模式示例：

"rooms": [
  {
    "given_name": "John",
    "family_name": "Smith",
    "smoking": false,
    "special_request": "Top floor or away from street please",
    "loyalty_id": "ABC123"
  }
],

备注：新字段将存在于多个地方

  • 创建预订请求
  • 行程检索
  • 行程变更

好处：

使合作伙伴能够包含酒店会员 ID，并将此信息传递给酒店。

* 信息仅供参考，不保证酒店会提供额外积分、礼遇

为 Rapid 房态响应添加了押金数据 - Shopping | Feature | V3

Rapid 3 将不需要我们的合作伙伴单独调用押金（付款安排）信息。相反，我们将把这些数据作为 Rate 对象的子对象显示。

除了无需另外调用押金（付款安排）数据外，我们还将在 priceCheck 响应中提供该数据以提高曝光度。

Rapid 3 模式示例：

"deposits": [
  {
    "value": "70.00",
    "due": "2021-08-21",
    "currency": "CAD"
  }
]

Rapid 3 将不再需要返回押金链接以供检索押金数据。将获取此信息并显示在响应中。

Rapid 2.4 模式示例：

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  },
  "deposit_policies": {
    "method": "GET",
    "href": "/2.4/properties/19248/deposit-policies?token=MY5S3j36cOcL"
  }
}

Rapid 3 模式示例：

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  }
}

Rapid 3 将不再返回 deposit_required 字段，因为对于新押金数组来说，该字段将是多余的。

Rapid 2.4 模式示例：

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"deposit_required": true,
"merchant_of_record": "expedia",

Rapid 3 模式示例：

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"merchant_of_record": "expedia",

好处：

合作伙伴将不再需要另外调用该数据。它将包含在响应中。

在 priceCheck 响应中添加了对度假短租 card_on_file_limit 和 refundable_damage_deposit 的支持 - Shopping | Feature | V3

添加了与度假短租相关的其他数据。card_on_file_limit 是针对住宿蒙受损失可以从卡中收取的最高金额，refundable_damage_deposit 是住宿所需的押金金额。响应中将只提供一个值，我们永远不会针对指定房价同时将这两个值返回给合作伙伴。

Rapid 3 模式示例：

"card_on_file_limit": {
  "value": "25.00",
  "currency": "CAD"
},
"refundable_damage_deposit": {
  "value": "75.00",
  "currency": "CAD"
}

好处：

合作伙伴可全面了解度假短租住宿的押金和预期。

住宿内容 API/文件和住宿目录文件中添加了 supply_source 必填字段 - Content | Feature | V3 | Breaking Change

住宿内容 API/文件和住宿目录文件中添加了一个新的 supply_source 必填字段，以使合作伙伴能够指定他们想要返回的库存类型。

传递“expedia”值只返回来自 Expedia 的库存。

传递“vrbo”值只返回来自 Vrbo 的库存。

Rapid 3 模式示例：

"supply_source": "vrbo"

备注：supply_source 现在是必填字段。要实现与以前版本的 API 相同的行为，合作伙伴将需要传递 "supply_source": "expedia"。

好处：

合作伙伴将能够通过与 Expedia 库存相同的端点访问 Vrbo 库存

住宿内容 API/文件中添加的新部分整合了度假短租的特定住宿和客房信息 - Content | Feature | V3 | Breaking Change

向 Rapid 内容/文件中添加了新的度假短租部分，合作伙伴可以在其中找到特定于度假短租的住宿信息，包括通常在多单元住宿的客房介绍中可见的属性。

在合作伙伴的付款页面上显示租房协议现在是度假短租住宿的一项 Rapid 上线要求。

Rapid 3 模式示例：

"vacation_rental_details": {
  "property_registration":{
  },
  "private_host"{
  },
  "property_manager": {
    "name": "Frans Belderbos",
    "links": {
      "image": {
        "method": "GET",
        "href": "https://odis.vrbo.com/odis/story/89cd116a-14fd-4fbc-a0d1-861894171cd0.c1.jpg"
      }
    },
    "rental_agreement": {
      "links": {
        "rental_agreement": {
          "method": "GET",
          "href": "https://www.vrbo.com/td/proxies/ecomQuote/downloadRentalAgreement?unitUrl=/units/0000/1341f175-3550-4c80-b9a1-b6b330b7e032"
        }
      }
    },
    "house_rules": [
        "Children welcome",
        "Pets welcome (restrictions apply)",
        "No smoking",
        "No parties or events"
      ],
    "amenities": {
        "1073743284": {
            "id": "1073743284",
            "name": "Heating"
        },
        "4296": {
            "id": "4296",
            "name": "Furnished balcony or patio"
        }
    }
  }
}

好处：

提供更多的住宿详细信息，从而改进独立单元度假短租的住宿显示，所有信息都包含在我们内容响应的度假短租特定部分中。

符合 PSD2 的第三方身份验证 - Booking | Feature | V3 | Breaking Change

一种新产品，使合作伙伴能够使用他们的首选支付服务提供商以满足 PSD2 合规要求

需要 cavv、eci、three_ds_version 和 ds_transaction_id 参数

Rapid 3 模式示例：

"third_party_authentication": {
  "cavv": "jELUbgG+Tgj0AREBDMLeCad+oIs=",
  "eci": "05",
  "three_ds_version": "2.2.0",
  "ds_transaction_id": "ac01cc2b-c1a1-4981-8c6f-400d4eec88de",
  "pa_res_status": "Y",
  "ve_res_status": "C",
  "xid": "47133847-13be-4ae3-9be9-e4053b9c83c0",
  "cavv_algorithm": "3",
  "ucaf_indicator": "0"
}

好处：

使合作伙伴能够使用他们的首选支付服务提供商以满足 PSD2 合规要求

添加了特殊字符编码以修复安全漏洞 - Booking | Bug Fix | V3 | Breaking Change

将重新编码几个字段中的特殊字符，以防范安全漏洞。

好处：

消除了潜在的安全漏洞。

修复了价格检查测试标头错误 - Shopping | Bug Fix | V3

价格检查调用的无效测试标头已重新命名，以匹配有效值。

Rapid 2.4 模式示例：

--header "Test: matched"

Rapid 3 模式示例：

--header "Test: available"

好处：

使合作伙伴能够更全面地测试他们与价格检查的集成。

修复了 customer_account_details 枚举中的错字 - Booking | Bug Fix | V3 | Breaking Change

修复了 customer_account_details 枚举中的错字，将“fido_authenticaton”更改为“fido_authentication”。

Rapid 2.4 模式示例：

"customer_account_details": {
  "authentication_method": "fido_authenticaton",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

Rapid 3 模式示例：

"customer_account_details": {
  "authentication_method": "fido_authentication",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

好处：

消除了可能造成合作伙伴困惑的拼写错误。

删除了交叉销售和替代住宿推荐 - Recommendations | Remove | V3 | Breaking Change

删除了 reference_property_id、destination_iata_airport_code、origin_iata_airport_code 和 iata_airline_code 参数。响应中将不再显示推荐链接。

Rapid 2.4 模式示例：

"recommendations": {
  "method": "GET",
  "href": "/2.4/properties/availability?token=abcdef"
}

好处：

合作伙伴将无法使用冗余请求参数进行调用

删除了 Fees 对象中弃用的字段 - Shopping | Booking | Manage Booking | Remove | V3 | Breaking Change

通过删除在显示费用总额时引起混乱的信息性字段，简化了 Fees 对象。

Rapid 2.4 模式示例：

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    },
    "scope": "per_person",
    "frequency": "per_day"
  }
}

Rapid 3 模式示例：

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    }
  }
}

好处：

删除了范围和频率，有助于明晰收取的费用。删除了不必要的字段，为合作伙伴简化了模式。

删除了 /properties/{property_id}/deposit-policies 路径 - Shopping | Remove | V3

deposit-policies 端点将被删除，因为它现在直接是房态调用的一部分。

好处：

合作伙伴无需另外调用即可获取押金政策信息。

明确了邮政编码描述 - Booking | Update | V3

简化了邮政编码字段的描述，减少混淆。

Rapid 2.4 模式示例：

客户的邮政编码。如果付款方式为信用卡（CC、CCC、VCC）且国家/地区代码为 US、GB 或 CA，则 Postal_Code 为必填项。

Rapid 3 模式示例：

邮政编码。

好处：

明确了该字段何时为必填项。

明确了房价计划计数描述 - Shopping | Update | V3

明确了房价计划计数描述：房价计划计数字段的描述已更新，现包含最小和最大限制值，并明确了该字段试图返回的内容（可用的最优价格）。

Rapid 2.4 模式示例：

每个住宿返回的房价数量。房价的价格决定了所返回的房价，例如 rateplancount=4 将返回最低的 4 个房价，但响应中的房价并非按从低到高或从高到低排序。经验证明，最低房价可提供最佳的转化率，因此建议将值设为 1。值必须大于 0。

Rapid 3 模式示例：

每个住宿返回的房价数量。系统将返回最优值房价，例如 rate_plan_count=4 将返回最优的 4 个房价，但响应中的房价并非按从低到高或从高到低排序。通常优先考虑最低房价。该值必须介于 1 和 250 之间。

好处：

明确了该字段的有效值。

明确了州/省代码描述 - Booking | Update | V3

简化了州/省代码字段的描述，减少混淆。

Rapid 2.4 模式示例：

客户所在的州或省的代码。如果 country_code = US、AU 或 CA，则为必填项

Rapid 3 模式示例：

澳大利亚、加拿大和美国的州/省代码（2 个字母或 3 个字母）。

好处：

明确了该字段何时为必填项。

另请参阅

签名生成器

EPS 通知服务测试器

新冠病毒疫情 Rapid 更新

住客点评

您觉得这个页面有用吗？
我们该如何改进这些内容？
感谢您帮助我们改进 Developer Hub！

隐私声明 Cookie 声明 使用条款

Expedia, Inc. 不对外部网站上的内容负责。
© 2024 Expedia, Inc.，Expedia Group 旗下公司。保留所有权利。Expedia 和飞机徽标是 Expedia, Inc. 的商标或注册商标。CST# 2029030-50。