Postman 컬렉션
Postman을 사용하여 Rapid API 엔드포인트를 테스트하고 구체적인 요청/응답 형식을 확인해 보세요
현재 이용 가능
현재 당사는 다음 항목에 대한 Postman 컬렉션을 제공하고 있습니다:
- Rapid Lodging API (알림 서비스 제외)
- Rapid 렌터카 API
아직 정식 출시되지 않은 Rapid Flight 및 Activities API에 대한 추가 컬렉션이 곧 제공될 예정입니다.
참고: 이 요청들은 사이트의 Swagger 자료와 연계하여 그룹화되어 있습니다.
이 컬렉션들은 가능한 한 self-contained 하게 작성되었습니다. 즉, 각 요청마다 인증 로직과 check-in/check-out self-update 를 캡슐화하고 있습니다. 또한 각 컬렉션에는 Postman의 컬렉션 실행기 기능과 함께 사용할 수 있는 몇 가지 기본 테스트가 포함되어 있습니다.
설치
컬렉션을 다운로드한 다음 Postman으로 가져오세요.
선행 조건 및 시스템 요구 사항
자세한 내용은 Postman 문서를 참고하시기 바랍니다. 특히 다음 사항에 유의하시기 바랍니다:
api_key및shared_secret- Postman 최신 버전
참고: “컬렉션 편집” 섹션을 수정하거나 변경하지 마십시오. 요청이 예상대로 작동하게 하려면 변수와 코드를 동일하게 유지해야 합니다.
구성
Postman은 변수를 자체 형식으로 처리합니다. 컬렉션을 사용하 려면 먼저 몇 가지 환경 변수를 설정해야 합니다.
다음 매개변수를 정의할 수 있으며, 이 중 2가지 매개변수만 필요합니다.
| 키 | 기본 | 필수 항목 | 설명 |
|---|---|---|---|
api_key | 해당 사항 없음 | 예 | API 키 |
shared_secret | 해당 사항 없음 | 예 | 공유 암호 |
eanapi_url | https://test.ean.com/ | — | 대상으로 지정할 호스트를 'https://api.ean.com'으로 재정의할 수 있습니다. |
property_id | 3609882 | — | 콘텐츠 및 예약 가능 여부 호출에서 요청할 LCM/Expedia property_id입니다. |
region_id | 178248 | — | 지리 관련 호출에서 요청할 지역입니다. |
iata_airport_code | ORD | — | 지리 관련 호출에서 요청할 IATA 공항 코드입니다. |
iata_airport_metro_code | CHI | — | 지리 관련 호출에서 요청할 IATA 공항 메트로 코드입니다. |
language | en-US | — | 요청할 현지화된 언어이며, BCP47 형식의 하위 집합입니다. |
occupancy | 2 | — | 요청할 객실당 인원 수로, numberOfAdults[-firstChildAge[,nextChildAge]]- "2-9,3" 형식은 성인 2명과 9세 아동 1명, 3세 아동 1명을 의미합니다. |
booking_email | john@example.com | — | 예약 요청에 사용된 이메일입니다. |
hold_itinerary_creation | true | — | 일정이 보류 상태로 생성되는지 여부입니다. |
billing_terms | 해당 사항 없음 | —* | 예약에 대한 청구 방법 조건입니다. |
partner_point_of_sale | 해당 없음 | —* | 쇼핑 및 예약 API에는 어떤 POS를 사용해야 합니까? |
payment_terms | 해당 사항 없음 | —* | 예약 비용을 지불할 때 사용해야 하는 결제 기간입니다. |
platform_name | 해당 사항 없음 | —* | 조회 및 예약에 사용할 플랫폼입니다. |
* 참고: 이 변수들은**#에서만 필요하며api.ean.com**;#의 경우에는 필요하지 않습니다.test.ean.com.
다음 매개변수들은 auto-generated 이며, 사용자의 환경에 자동으로 설정됩니다:
| 키 | 전역 | 설명 |
|---|---|---|
authorizaton | 예 | 이 인증 코드는 api_key 및 shared_secret에서 생성되어 요청 헤더로 사용됩니다. |
checkin | 예 | checkin 날짜는 예약 가능 여부 요청 시 자동 생성됩니다. 항상 요청한 날부터 30일입니다. |
checkout | 예 | checkout 날짜는 예약 가능 여부 요청 시 자동 생성됩니다. 항상 요청한 날부터 32일입니다. |
arrival | 예 | arrival 시간은 교차 판매 요청 시 자동 생성됩니다. 항상 요청한 시간부터 30일입니다. |
affiliate_reference_id | — | affiliate_reference_id는 예약 생성 요청에 사용되며, 후속 예약을 검색하는 데 이용할 수 있습니다. |
price_check_link | — | price_check_link는 반환된 숙박 시설에 해당 링크가 있는 경우 예약 가능 여부, 교차 판매 또는 추천 요청 후에 설정됩니다. 요금 확인 요청에 사용할 수 있습니다. |
payment_options_link | — | payment_options_link는 반환된 숙박 시설에 해당 링크가 있는 경우 예약 가능 여부, 교 차 판매 또는 추천 요청 후에 설정됩니다. 결제 옵션 요청에 사용할 수 있습니다. |
deposit_policies_link | — | deposit_policies_link는 반환된 숙박 시설에 해당 링크가 있는 경우 예약 가능 여부, 교차 판매 또는 추천 요청 후에 설정됩니다. 보증금 정책 요청에 사용할 수 있습니다. |
book_link | — | book_link는 반환된 숙박 시설에 해당 링크가 있는 경우 요금 확인 요청 후에 설정됩니다. 예약 요청에 사용할 수 있습니다. |
retrieve_link | — | retrieve_link는 반환된 일정에 해당 링크가 있는 경우 예약 요청 후에 설정됩니다. 검색 요청에 사용할 수 있습니다. |
resume_link | — | resume_link는 반환된 일정에 해당 링크가 있는 경우 예약 요청 후에 설정됩니다. 재개 요청에 사용할 수 있습니다. |
cancel_link | — | cancel_link는 반환된 일정에 해당 링크가 있는 경우 예약 요 청 후에 설정됩니다. 취소 요청에 사용할 수 있습니다. |
cancel_room_link | — | cancel_room_link는 반환된 일정에 해당 링크가 있는 경우 예약 요청 후에 설정됩니다. 객실 취소 요청에 사용할 수 있습니다. |
change_room_link | — | change_room_link는 반환된 일정에 해당 링크가 있는 경우 예약 요청 후에 설정됩니다. 객실 변경 요청에 사용할 수 있습니다. |
complete_payment_session_link | — | complete_payment_session_link는 반환된 일정에 해당 링크가 있는 경우 예약 요청 후에 설정됩니다. 결제 세션 완료 요청에 사용할 수 있습니다. |
pagination_link | — | pagination_link는 페이지 번호가 매겨진 엔드포인트에 대해 수행된 요청 후에 설정됩니다. API에서 페이지 지정이 어떻게 이루어지는지 보여주는 데 사용할 수 있습니다. |
추천 구성
eanapi_url와api_keyshared_secret 만 설정된 환경에서 변수를 정의할 것을 권장합니다.
Postman 컬렉션 다운로드
이 컬렉션을 다운로드하기 전에 반드시 이 페이지의 지침을 읽어보시기 바랍니다.