끝점

별도의 설명이 없는 한 이러한 끝점 및 메소드가 모든 API 요청에 적용됩니다.

예약 요청은 POST을(를) 통해 별도의 보안 종료 지점에 전송되어야 합니다.

일반 요청: GET http://api.ean.com
예약 요청: POST https://book.api.ean.com
일반적인 요청 매개 변수
이러한 매개 변수의 대부분은 API에 대한 모든 요청의 일부로 전송되어야 합니다. 일부 매개 변수는 테스트를 위해 선택적으로 제공되거나 특정 설정에서만 필요합니다.

이름 필수 설명
apiExperience 문자열 필수

이 속성을 사용하여 요청의 원본을 식별할 수 있습니다. 제출한 각 요청의 아래에 제시된 집합에서 해당 값을 선택합니다.

값:
PARTNER_CALL_CENTER - 콜센터 담당자 요청
PARTNER_WEBSITE - 고객용 웹 사이트 요청
PARTNER_MOBILE_WEB - 모바일 형식 웹 사이트 요청
PARTNER_MOBILE_APP - 모바일 앱 요청
PARTNER_BOT_CACHE - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청
PARTNER_AFFILIATE - 고유 제휴사 기반으로 서비스하는 API/플랫폼 요청

cid 정수(Long) 필수

EAN이 발급된 계정 ID입니다. 이 번호는 실시간 사이트에서 통계 및 수수료 목적으로 판매를 추적하는 데 사용됩니다.

인증의 일부로 apiKey와 연결됩니다.

apiKey 문자열 필수 API에 대한 EAN이 발급된 액세스 키입니다. 실시간 예약, 인증 방법(IP 또는 서명 기반) 및 요청 한도에 대한 액세스 여부를 결정합니다.

전체 인증의 일부로 cid와 연결됩니다.
minorRev 정수 필수 요청을 처리하고 응답을 반환하는 데 사용하는 경미한 수정을 설정합니다.
생략된 경우 기본값은 24(가장 오래된 지원 릴리스)입니다.
locale 문자열 필수 고객의 국가와 예약 시 사용한 판매 장소의 국가를 식별합니다. 지원 로케일을 참조하십시오.

기본값: en_US
currencyCode 문자열 필수 아님, 예약 및 결제 유형 전용 데이터를 사용 가능한 다른 통화로 반환합니다.

예약할 때 이 값이 이전의 예약 가능 객실 응답에서 ChargeableRateInfo 노드 내에 반환된 값과 일치해야 요금 불일치 오류를 방지할 수 있습니다.

기본값: USD
customerSessionId 문자열 필수 각 고객에 대해 첫 번째 호텔 목록 검색으로 시작하는 고유한 값을 삽입하거나 첫 번째 목록 응답에서 반환된 값을 나머지 예약 경로에서도 사용하십시오.

새로운 고객 세션마다 새로운 값을 사용하면서 각 예약 세션 중에 각 고객에 대해 계속 같은 값을 전달합니다.

이 값을 포함하면 개별 고객에 대한 요청 경로를 확실히 연결하기 때문에 파트너 요청 문제에 대한 EAN의 내부 디버깅 프로세스가 훨씬 간편해집니다.

customerIpAddress 문자열 필수 통합에 의해 캡처되는 고객의 IP 주소입니다. IPV4 주소만 전송합니다.

통합 시 본인의 IP가 아닌 고객의 IP를 전달해야 합니다. 이 값을 사용하여 고객의 위치를 파악하고 올바른 결제 게이트웨이를 할당할 수 있습니다.

또한 사기 복구 및 기타 주요 분석에 사용됩니다.
customerUserAgent 문자열 필수

통합에 의해 캡처되는, 고객 요청의 user-agent 헤더 문자열입니다.

API는 원시 user-agent 문자열의 컨텐츠를 통해 모바일 장치의 사용을 감지합니다.

모바일 또는 데스크탑 앱에서 전송되는 트래픽의 경우 다음 형식을 사용합니다.
{App Name}/{App Version} ({OS} {OS Version}) [APP or MOBILE_APP]

:

TravelWizard/1.0 (iOS 10_10_3) MOBILE_APP
Explorer/2.1 (Windows 7) APP
Explorer/2.1 (Linux 2.6.32) APP

사용하지 않음: 모바일 사이트의 경우 이 요소 내의 원하는 위치에 문자열 값 MOBILE_SITE를 포함합니다. 모바일 앱의 경우 MOBILE_APP을 사용합니다. 이러한 값은 그 자체로 전송되거나 확인된 사용자 대행사 문자열에 첨부될 수 있습니다. 참고: MOBILE_SITE 지원은 향후 제거될 수 있습니다.

데스크톱 브라우저는 모바일 문자열 또는 모바일별 키워드가 모두 감지되지 않는 것으로 간주합니다.

sig 문자열 서명 인증을 사용하는 경우 필수 서명 값은 서명 인증과 함께 사용되며 표시되는 모든 코드를 제거해야 합니다.

모든 서명 값은 32자 이내의 소문자로 구성되어야 합니다.

디지털 서명을 생성할 때 오류가 발생하면 Ping 요청을 전송하여 EAN에 대한 Unix 시간을 확인하거나 EAN 서명 생성기에 대한 값을 확인합니다.