利用開始の準備
まず、最終的な添付リンクURLを生成するために必要な情報をすべて収集します。
以下に、必要な詳細情報のリストを記載いたします：
| 要件 | 発生元 | 説明 |
|---|---|---|
partnerid | 以下の方によって共有されますExpedia Group. | リクエストパラメータで使用される文字列値です。(例 : partnerid = partnername_hotel_conf_overlay)。 |
| 秘密鍵／プライベートキー | 以下の方々が共有しますExpedia Group. | 各.に対して署名を生成するために使用される、36文字の英数字の文字列ですpartnerid。例：1ページ目： partnerId = partnername_hotel_conf_overlaysecret key = 6f437404-261d-4beb-a7fc-43b92f6948312ページ目： partnerId = partnername_hotel_itin_overlaysecret key = 89f37407-821r-3des-a7f5-ghb92f694294 |
| トラッキング コード | 以下の方々が共有しますExpedia Group. | パートナーサイトへの掲載における収益の帰属を追跡するために使用されるコードです。 |
| ディープリンクURL | 以下の方々が共有します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 | ディープリンクガイドに従い、パートナードメイン、検索パラメータ、およびトラッキングコードを使用して、ホテルの検索結果ページへのディープリンクリクエスト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規格に準拠した日付の文字列表現です。 | 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 | Boolean (ブール型) | Y | 割引適用率を有効にするには、この値を「true」に設定 してください。 | true |
signature | 文字列 | Y | パートナーが、以下から提供された秘密鍵に基づいて、server-sideを生成しました。Expedia Group. この文字列の長さは、ちょうど27文字です。生成されたバイナリ署名をエンコードしてください。 | BcND1F7KElTyGtyUHeXHd2JJLFs |
注： のリクエストパラメータは、大文字と小文字を区別します。大文字と小文字が間違っていると、エラーが発生します。