開始使用
第一步是彙整所有生成最終附件連結網址所需的資訊。
以下是您需要的詳細資訊清單：
| 需求 | 來源 | 說明 |
|---|---|---|
| 合作夥伴識別碼 | 由……分享 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 |