開始使用
第一步是彙整所有必要資訊，以便產生最終的附件連結網址。
以下是您需要了解的詳細資訊清單：
| 需求 | 來源 | 說明 |
|---|---|---|
| 合作夥伴識別碼 | 由以下人士分享：Expedia Group. | 「合作夥伴 ID」是請求參數中使用的字串值。 例如： PartnerId =partnername_hotel_conf_overlay |
| 私鑰 | 由以下人士分享：Expedia Group. | 秘密金鑰是由 Expedia Group 針對每個合作夥伴 ID 安全共享的一串字母數字字串，用於產生簽名。此金鑰長度為 36 個字元。例如： 第 1 頁： • PartnerId = partnername_hotel_conf_overlay• 密鑰 = 6f437404-261d-4beb-a7fc-43b92f694831第 2 頁： • PartnerId = partnername_hotel_itin_overlay• 私密金鑰 = 89f37407-821r-3des-a7f5-ghb92f694294 |
| 追蹤代碼 | 由以下人士分享：Expedia Group. | 用於追蹤合作夥伴網站廣告位收入歸因的追蹤程式碼。 |
| 端點 | xsell-redirect-pwa | |
| HMAC-SHA1 演算法函式庫 | https://commons.apache.org/crypto/download_crypto.cgi | 使用 HMAC-SHA1 演算法函式庫來產生簽名。 https://download.java.net/java/early_access/panama/docs/api/java.base/javax/crypto/package-summary.html |
| URL 編碼 UTF-8 | http://en.wikipedia.org/wiki/Percent-encoding | |
| 建立飯店結果頁面第一個 URL 的深度連結指南。 | 深層連結 | 關於建立標準深度連結的說明，詳見本文。 注意： 中的「目的地」必須與您的範本網站所支援的地區設定相符。 |
電子郵件附件連結的 URL 請求參數
注意： 的請求參數會區分大小寫。若大小寫不正確，將會導致錯誤。
| 參數 | 類型 | 必選／選填 | 說明 | 範例值 |
|---|---|---|---|---|
PartnerId | 字串 | 必填 | 由……提供 Expedia Group. | partnername-POS-Ext-Flight-Conf-EmailDL |
url | 字串 | 必填 | 請依照深度連結指南，使用合作夥伴網域、搜尋參數及追蹤代碼，建立飯店結果頁面的深度連結請求網址。請確保已包含追蹤代碼 (mdpcid)，且輸出參數的值已正確設定為 URL-encoded. >> 閱讀深度連結指南 | url = https%3A%2F%2Fexpedia.com%2Fgo%2Fhotel%2Fsearch%2FDestination%2F2025-12-22%2F2025-12-25%3Fmdpcid%3DMDPCID=Expedia-IE.DPS.en_IE.confemail.attachDL.Flightl%26CityName%3DORD%26SortBy%3Ddistance%26NumRoom%3D1%26NumAdult1%3D3%26NumChild1%3D2%26Rm1child1age%3D9%26Rm1child2age%3D6n |
outboundEndDateTime | 符合 ISO 8601 標準的日期字串表示法。 | 必填 | 請指定旅程抵達目的地的日期與時間。它應僅包含符合 ISO 8601 標準的日期、時間及時區。 此參數值需要進行編碼。 | 2025-10-30T20%3A12%3A17.928020Z |
originTLA | 字串 (3 個字母) | 必填 | 請指定旅程起點的 IATA 機場代碼。 | LAS |
returnStartDateTime | 符合 ISO 8601 標準的日期字串表示法。 | 可選項——僅適用於往返行程 | 請指定從目的地出發的返程日期與時間。根據 ISO 8601 標準，其中僅可包含日期、時間及時區。 此參數值需要進行編碼。 | 2025-11-10T20%3A12%3A17.928020Z |
destinationTLA | 字串 (3 個字母) | 必填 | 請指定旅程目的地的 IATA 機場代碼。 | JFK |
bookingDateTime | 符合 ISO 8601 標準的日期字串表示法。 | 必填 | 請指定已預訂的日期與時間。根據 ISO 8601 標準，其中僅可包含日期、時間及時區。 此參數值需要進行編碼。 | 2025-07-25T20%3A12%3A17.928020Z |
bookingStatus | 字串 | 可選項——若未提供，我們將視為預訂已確認。 | 此參數的有效值為： • confirmed• pending• failed折扣價僅在「 bookingStatus」確認後方適用。 | confirmed |
attachDL | 布林值 | 必填 | 將值設定為true，以啟用折扣附加費率。 | true |
signature | 字串 | 必填 | server-side 由合作夥伴根據由 Expedia Group. 這串字串的長度正好是 27 個字元。對生成的二進位簽名進行編碼。 | BcND1F7KElTyGtyUHeXHd2JJLFs |