Developer Hub

變更記錄

以下清單列出在 Rapid API 中發生的所有變更，依釋出月份分組。

|

2024 年 4 月

會員計畫 - Book | Shop | Feature | V3

我們正在增加新功能，讓您能更輕鬆尋找提供旅宿會員計畫相關積點機會的企業房價。深入了解我們的飯店會員點數。

效益：

合作夥伴將擁有更強大的工具，協助商務旅客獲得旅宿會員計畫中的點數。

2024 年 1 月

行銷費用獎勵 - Shop | Feature | V3

為 Shop 要求的 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

要變更要求，請將 sale_scenario.mobile_promotion 值加入 include 參數中，以獲得供應情況和購物的資訊。

要變更回應，請將 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
  }
]

效益：

若合作夥伴想要更輕鬆地確定哪些房價與行動裝置專屬促銷優惠有所關聯，他們現在有了新的方法可達成。

新公車站 Region 類型 - Geography | Feature | V3

將 bus_station 地區類型加入到 Region 端點的要求中。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

將 free_text 新增到旅宿內容回應的 vacation_rental_details 部分。

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 與 Rapid 整合指南

進階地區搜尋 - Geography | Feature | V3

新增以下搜尋參數：

  • area 使用半徑和 (經緯度) 座標或地區 ID 來定義區域
  • limit 限制傳回的結果數量
  • country_subdivision_code 傳回符合 ISO 3166-2 國家/地區分區代碼的結果

將 country_subdivision_code 新增至 Regions 和 Region 的回應

效益

合作夥伴可以選擇與其所定義區域相交的地區。

搜尋某經緯度座標半徑 50 公里內的機場：

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

OpenAPI 規格改良 - Update | V3

OpenAPI 規格有以下幾個改良的地方：

  • 日期加上引號，如此一來便會正確顯示在 API Explorer
  • 再次修改 BoundingPolygon，以提高和 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

效益：

合作夥伴可指定回應中不包括含可退款損壞保證金的房價。

明確的地理 Polygon 和範例 - Geography | Update | V3

規格中對於座標要求和回應中「多邊分界」格式的細節有不正確的描述。因此將範例更新為可供 API Explorer 使用的地理端點。

此變更不影響 API 功能，僅修正 OpenAPI 規格。

Rapid 3 結構描述範例：

以下為一地區回應的截圖範例：

"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
            ]
          ]
        ]
      }
    },

效益：

該規格現在準確地反映地區可傳回多邊分界 (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

地理呼叫現在具有以下增強功能：

  • 為「多邊分界」要求中的 Region、Regions 和 Properties 新增 supply_source 篩選條件。
  • 為多邊分界回應中的 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"
]

效益：

合作夥伴可運用類別和標籤，取得回傳區域相關的中繼資料資訊。

已淘汰 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 的一致性。

移動了 Refundable Damage Deposit 和 Card On File Limit 欄位以與 Shop 保持一致 - Manage Booking | Change | V3 | Breaking Change

為了與 Shop 保持一致，移動了 Refundable Damage Deposit 和 Card On File limit 欄位。

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 的一致性。

將 Deposit Policy 重新命名為 Deposits 以與 Shop 保持一致 - Manage Booking | Change | V3 | Breaking Change

為了與 Shop 保持一致，將 Deposit Policy 重新命名為 Deposits。

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

  • 與此客房旅客相關的飯店會員計畫識別碼。
  • 存在於房型物件下

Rapid 3 結構描述範例：

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

備註 新欄位將位於多個地方

  • 建立預訂申請
  • 行程擷取
  • 行程變更

效益：

使合作夥伴能夠加入飯店會員 ID，並將此資訊傳遞給飯店。

*資訊僅供參考，不保證飯店會提供額外積分或禮遇

將 deposit 資料新增至 Rapid 供應情況回應 - Shopping | Feature | V3

Rapid 3 將不再需要我們的合作夥伴單獨呼叫 deposit (付款安排) 資訊。反之，我們會將這些資料做為房價物件的子物件。

除了無需額外呼叫 deposit (付款安排) 資料外，我們還將在 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"
    }
  }
}

效益：

移除 scope 和 frequency，以協助釐清收取的費用。不但移除不必要的欄位，還可簡化合作夥伴的結構描述。

已移除 /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 結構描述範例：

適用於澳洲、加拿大和美國的雙字母或 3 字母州/省代碼。

效益：

明確說明此欄位在什麼情況下為必填。

其他參考文件

COVID-19 Rapid 更新

EPS 通知測試

旅客評語

Signature Generator

這個頁面有幫助嗎？
我們能如何改善內容？
感謝您協助改善 Developer Hub！

隱私權聲明Cookie 聲明使用條款

Expedia, Inc. 針對外部網站的內容恕不負責。
© 2024 Expedia, Inc. 為 Expedia Group 旗下公司。著作權所有，並保留一切權利。Expedia 智遊網和飛機標誌為 Expedia, Inc. 的商標或註冊商標。CST# 2029030-50。