開始使用
第一步是彙整所有必要資訊，以便產生最終的附件連結網址。
以下是您需要了解的詳細資訊清單：
| 需求 | 來源 | 說明 |
|---|---|---|
partnerid | 由以下人士分享：Expedia Group. | 用於請求參數的字串值。例如：partnerid = partnername_hotel_conf_overlay |
| 私鑰 | 由以下人士分享：Expedia Group. | 一個由 36 個字母數字組成的字串，用於為每個 . 產生簽名partnerid。例如：第 1 頁： partnerId = partnername_hotel_conf_overlaysecret key = 6f437404-261d-4beb-a7fc-43b92f694831第 2 頁： partnerId = partnername_hotel_itin_overlaysecret key = 89f37407-821r-3des-a7f5-ghb92f694294 |
| 追蹤代碼 | 由以下人士分享：Expedia Group. | 用於追蹤合作夥伴網站廣告位收入歸因的代碼。 |
| 深度連結網址 | 由以下人士分享：Expedia Group. | 範例： https://partnersitedomain/xsell-redirect-pwa?url=https%3A%2F%2Fpartnersitedomain%2Fgo%2Fhotel%2Fsearch%2FDestination%2F2026-08-25%2F2026-08-27%3FTrackingCodeHOTEL%26CityName%3DLAS%26SortBy%3DRECOMMENDED%26NumRoom%3D1%26NumAdult1%3D2&outboundEndDateTime=2026-08-25T16%3A53%3A00.000000Z&destinationTla=LAS&returnStartDateTime=2026-08-27T16%3A53%3A00.000000Z&originTla=SEA&bookingDateTime=2026-08-11T16%3A53%3A00.000000Z&attachDL=true&partnerId&signature |
| 端點 | xsell-redirect-pwa | 建立連線所需的端點。這是 case-sensitive. |
| HMAC-SHA1 演算法函式庫 | 請選擇其中一項 >> Apache Commons Crypto 或 | |
| >> Javax Crypto | 用於產生簽名。 | |
| URL 編碼 UTF-8 | >> UTF-8 百分比編碼 | 用於對請求 URL 進行編碼，以確保傳輸安全 |
電子郵件附件連結的 URL 請求參數
| 參數 | 類型 | 必填 | 說明 | 範例值 |
|---|---|---|---|---|
partnerid | 字串 | Y | 由……提供 Expedia Group. | partnername-POS-Ext-Flight-Conf-EmailDL |
url | 字串 | Y | 請依照深度連結指南，使用合作夥伴網域、搜尋參數及追蹤代碼，建立飯店結果頁面的深度連結請求網址。請確保已加入追蹤代碼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 標準的日期字串表示法。 | Y | 請指定旅程抵達目的地的日期與時間。它應僅包含符合 ISO 8601 標準的日期、時間及時區。 此參數值需要進行編碼。 | 2025-10-30T20%3A12%3A17.928020Z |
originTLA | 字串 (3 個字母) | Y | 請指定旅程起點的 IATA 機場代碼。 | LAS |
returnStartDateTime | 符合 ISO 8601 標準的日期字串表示法。 | 僅適用於往返行程 | 請指定從目的地出發的返程日期與時間。根據 ISO 8601 標準，其中僅可包含日期、時間及時區。 此參數值需要進行編碼。 | 2025-11-10T20%3A12%3A17.928020Z |
destinationTLA | 字串 (3 個字母) | Y | 請指定旅程目的地的 IATA 機場代碼。 | JFK |
bookingDateTime | 符合 ISO 8601 標準的日期字串表示法。 | Y | 請指定已預訂的日期與時間。根據 ISO 8601 標準，其中僅可包含日期、時間及時區。 此參數值需要進行編碼。 | 2025-07-25T20%3A12%3A17.928020Z |
bookingStatus | 字串 | 若未提供相關資訊，我們將視該預訂為已確認。 | 此參數的有效值為： • confirmed• pending• failed折扣價僅在「 bookingStatus」確認後方適用。 | confirmed |
attachDL | 布林值 | Y | 將值設定為true，以啟用折扣附加費率。 | true |
signature | 字串 | Y | 由合作夥伴根據由提供的密鑰所生成的 server-side Expedia Group. 這串字串的長度正好是 27 個字元。對生成的二進位簽名進行編碼。 | BcND1F7KElTyGtyUHeXHd2JJLFs |
注意： 的請求參數區 分大小寫。若大小寫不正確，將會導致錯誤。