Rapid 시작하기

Rapid를 시작하는 것은 간단합니다. API 키와 공유 암호를 가져오고, Rapid 인증을 구성한 다음 테스트를 시작하면 됩니다.

1. 파트너로 등록하기

아직 파트너가 아닌 경우 파트너 등록을 신청해야 Rapid 통합을 진행할 수 있습니다.

2. 웹사이트에 해당되는 출시 요구 사항 검토

출시 요구 사항을 검토하여 프런트엔드 UI 개발이 필요한 요구 사항을 결정하고 이를 프로젝트 계획에 반영합니다.

• B2B 단독
• B2C 단독

3. 환경 준비

다음 리소스를 검토하여 Rapid 사용을 위한 환경을 준비해 주세요.

• 작동 방식
• 예약 요청 처리
• 취소 정책 구성

4. 자격 증명 가져오기 및 Rapid 인증 구성

파트너로 등록하고 Rapid와의 통합이 승인되면 API 키를 받아야 합니다. 이를 위해서는 EPS 포털에 로그인하고 왼쪽 메뉴에서 연결을 클릭합니다. 그런 다음, 옵션에서 API 키를 선택합니다. 현재 API 키 세부 정보가 표시됩니다.

API 키는 Rapid의 서명 인증 시스템에 요구되는 두 가지 유형의 주요 자격 증명 중 하나입니다. 여기에는 공유 암호가 함께 필요하며, EPS 포털에서 API 키 페이지로 이동해 확인하실 수 있습니다. API 키는 사이트 검토 후 프로덕션 환경에서의 출시를 승인받을 때까지 제한된 개발 모드로 설정됩니다.

API 서비스에 대한 요청을 만들려면 테스트 단계 또는 프로덕션 단계와 관계없이 HTTP 인증 헤더를 사용하여 각 요청에 포함된 SHA-512 서명 해시와 API 키를 전송합니다. SHA-512 해시는 공유 암호, API 키 및 현재 UNIX 타임스탬프로 구성되어 있습니다. Rapid 인증 헤더는 항상 다음과 같은 형식을 사용합니다.

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

자세한 내용은 서명 인증 페이지를 참조해 주세요. 서명 생성기 도구를 사용하여 통합을 테스트할 SHA-512 해시 값을 생성할 수 있습니다.

5. 요청 테스트 시작

자격 증명을 받고 Rapid 인증을 구성하면 테스트 엔드포인트인 https://test.ean.com/에서 요청 만들기를 시작할 수 있습니다. https://test.ean.com/에서 이루어진 예약 요청은 실제 숙박 시설 예약이나 신용카드 청구 내역에 포함되지 않습니다. 예약 API에 문서화된 테스트 헤더에서 선택하여 확인하고 싶은 응답 유형을 제어할 수 있습니다. 또는 예약 관련 요청에 대한 테스트 헤더를 생략할 경우 테스트 서버가 자동으로 하나 추가됩니다.

중요: 모든 파트너에게 안정적이면서도 유지관리가 가능한 서비스를 제공하기 위해 속도 제한이 적용됩니다. 시스템은 비정상적인 API 트래픽을 모니터링하고 시스템 보호를 위한 조치를 자동으로 취합니다. API 호출 동작에 대한 계획된 변경 또는 API에 액세스하여 성능 테스트를 수행하기 전에 담당 Rapid 컨설턴트와 계획을 검토해 주세요.

API 버전 지정

OpenAPI 사양의 servers.url 값을 사용하여 URL을 구성합니다. test.ean.com은 통합 검증용이고 api.ean.com은 프로덕션 엔드포인트입니다. 엔드포인트 간 전환 시 프로토콜과 경로를 유지해 주세요.

https://test.ean.com/v3/itineraries?… https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

servers.url 값은 다운로드 가능한 OpenAPI 사양 파일의 상단에서 확인할 수 있으며, 항상 지정된 API 서비스의 버전 번호와 일치합니다.

예: OpenAPI 사양

openapi: 3.0.1
info:
  title: Rapid
  description: EPS Rapid V3
  version: v3
servers:
  - url: https://test.ean.com/v3

6. 사이트 검토 요청

통합이 원활하게 이루어지고 해당 출시 요구 사항을 충족하는지 확인했다면 비즈니스 개발 매니저에게 사이트 검토를 요청해 주세요. 승인되면 비즈니스 개발 매니저가 프로덕션용 API 키를 활성화해 드립니다. 요청 엔드포인트를 https://test.ean.com/에서 https://api.ean.com으로 전환하고 요청 만들기를 계속합니다. 이때 추가로 코드를 변경할 필요가 없습니다.