우체부 컬렉션
Rapid API 엔드포인트를 테스트하고 Postman으로 구체적인 요청/응답 형식을 확인하세요.
현재 사용 가능
현재 제공되는 포스트맨 컬렉션은 다음과 같습니다:
- 빠른 숙박 API(알림 서비스 제외)
- 빠른 자동차 API
아직 일반에 공개되지 않은 빠른 비행 및 활동 API를 위한 추가 컬렉션이 곧 출시될 예정입니다.
참고: 이러한 요청은 사이트의 스웨거 자료와 관련하여 그룹화되어 있습니다.
컬렉션은 가능한 한 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에 사용할 판매 시점. |
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만 설정된 환경에서 변수를 정의하는 것이 좋습니다.
포스트맨 컬렉션 다운로드
이러한 컬렉션을 다운로드하기 전에 이 페이지의 지침을 읽어 보세요.