Developer Hub
This is an auto-generated translation

注意: EGI 目前並非所有合作夥伴皆可使用。如果您有興趣啟用此庫存,請聯絡您的客戶經理,以進一步了解存取 EGI 所需的條件。

Rapid Lodging API 的全球庫存範圍已擴大

透過全球各地擴充的庫存,在全球範圍內展開競爭

Expedia 擴展全球房源庫 (EGI) 能協助您與全球超過 34,000 家住宿設施競爭,且房源數量正持續增加。這包括新取得的不動產,以及目前已取得的不動產中的新增庫存。

技術細節

EGI 並非 Rapid API, 的標準套件庫的一部分,但可應要求明確啟用。其動態行為與整合模式有別於標準庫存系統,因此在內容導入、購物及預訂工作流程中,皆需特別留意。

內容檔案

EGI 的 Rapid Content File 和 Catalog File API 目前僅支援 English-language 上的內容。如果您的系統需要本地化的 (non-English) 內容檔案,您可以透過旅宿內容 以及地理 API 在本地端進行生成。這些 API 提供 real-time 串流功能,並能靈活處理所有內容語言,讓您能輕鬆從 JSON-formatted API 回應中擷取所需資訊。您可以將原始 JSON 回應儲存於本地端,以便日後處理,或進行轉換以供資料庫匯入或其他用途。

以下是使用 Geography API 查詢特定區域的物件清單的範例:

/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_ids

使用旅宿內容 API 請求目錄內容的範例:

/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalog

您可以選擇優先推出 EGI 的內容整合功能,同時預留更多時間審查購物與預訂的工作流程;或者,當您覺得已為 EGI 做好準備時,也可以將這三個組件一併推出。有關設定的詳細資訊,請聯絡您的整合顧問。

客房資料對齊

在您的系統與旅宿內容 API 完全同步之前,購物 API 中可能會出現新的旅宿房間。為維持一致的使用者體驗,請考慮暫時將這些房間從客戶端顯示中排除、觸發針對新客房的 real-time 內容 API 呼叫,或增加本地內容的更新頻率,以盡量減少資料延遲。

費率識別碼

EGI 的定價結構與標準庫存不同,並採用更為動態的資料模型。由於這些費率沒有固定數值,Shopping API 會以動態的 ``rate_id 值返回這些費率,而該值並不對應於旅宿 Content API 中的數值。此動態字串值由數字、字母及各種其他符號組成,在每個 Shopping API 回應中可能有所不同。因此,rate_id 的值並不穩定,不應作為持久性識別碼或主鍵使用。如果您的系統需要區分不同流程的費率,請考慮透過政策屬性與產品特徵的組合來進行匹配。參見 此受保護的文件 欲了解更多詳情。

以下是 Shopping API 回應中 rate_id 值的範例:

[
  {
    "property_id": "ABC152",
    "status": "available",
    "rooms": [
      {
        "id": "XYZ652",
        "room_name": " Deluxe Double ",
        "rates": [
          {
            "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
            … …

床位配置的多樣性

在特殊情況下,某些客房可能沒有指定的床型配置,這會在 Content API 和 Shopping API 中透過bed_groups ID 為 0 以及「床型未指定」的描述來標示。這意味著旅宿將決定床鋪的排列方式 check-in. 雖然這種情況較為罕見,但您的系統應持續向客戶通報相關資訊;若客戶有明確偏好,請協助其向我們的客戶服務團隊提出特殊要求。

以下是購物 API 回應中未指定床型配置的範例:

{
  "bed_groups": {
    "0": {
      "id": "0",
      "description": "Bed Not Specified",
      "links": {
        "price_check": {
          … …

保留和復原

某些 EGI 費率與 Booking API () 的「暫停與恢復」()工作流程不相容,若嘗試暫停服務,系統將返回錯誤。為避免造成不良的客戶體驗,您可以在 Shopping 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 各項功能 (包括 Soft Change、Hard Change 以及旅宿訊息中心) 的代碼連結,也將在「管理預訂 API」中提供。有時,代幣連結可能需要長達五分鐘才能準備就緒。請注意,這些功能並非適用於所有預訂,應在您的系統中妥善處理。

EGI 的主要差異

功能/行為標準庫存擴充全球庫存
預設可用性預設為啟用應要求啟用
費率識別碼靜態、持久動態,各店有所不同
內容解決方案相容於檔案 API 及串流內容 API支援英文內容的檔案 API,以及所有語言的串流內容 API
內容同步要求熱門房源的每日同步熱門房源的每日同步
床型和數量設定已指定在極少數情況下可能未指定
保留和復原適用於所有預訂部分預訂適用
Post-booking 特色適用於所有預訂部分預訂適用
這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!