시작하기
첫 번째 단계는 최종 첨부 링크 URL을 생성하는 데 필요한 모든 정보를 수집하는 것입니다.
필요한 세부 정보 목록은 다음과 같습니다:
| 요구 사항 | 소스 | 설명 |
|---|---|---|
| 파트너 식별자 | 공유 대상 Expedia Group. | 파트너 ID는 요청 매개변수에 사용되는 문자열 값입니다. 예: PartnerId =partnername_hotel_conf_overlay |
| 비밀/개인 키 | 공유 대상 Expedia Group. | 비밀 키는 각 파트너 ID에 대해 Expedia Group 에서 안전하게 공유하는 영숫자 문자열로, 서명을 생성하는 데 사용됩니다. 이 키의 길이는 36자입니다. 예를 들어 예: 1페이지: • PartnerId = partnername_hotel_conf_overlay• 비밀 키 = 6f437404-261d-4beb-a7fc-43b92f6948312페이지: • 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 | String | 필수 항목 | 제공처 Expedia Group. | partnername-POS-Ext-Flight-Conf-EmailDL |
url | String | 필수 항목 | 디링크 가이드 에 따라 파트너 도메인, 검색 매개변수, 추적 코드를 사용하여 호텔 결과 페이지의 디링크 요청 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 | String | 선택 사항 - 제공하지 않으면 예약이 확정된 것으로 간주합니다. | 이 매개 변수의 유효한 값은 다음과 같습니다: • confirmed• pending• failed할인 요금은 bookingStatus확인 시에만 적용됩니다. | confirmed |
attachDL | 부울 | 필수 항목 | 값을 true으로 설정하여 할인된 첨부 요금이 적용되도록 합니다. | true |
signature | String | 필수 항목 | 파트너가 제공한 비밀 키를 기반으로 server-side 생성됨 Expedia Group. 이 문자열의 길이는 정확히 27자입니다. 결과 바이너리 서명을 인코딩합니다. | BcND1F7KElTyGtyUHeXHd2JJLFs |