빠른 항공편 API 파일럿 문서
얼리 액세스 미리 보기
이 문서는 일부 파트너에게만 제공되는 얼리 액세스 미리 보기 이니셔티브의 일부입니다. 파일럿 프로그램은 2025년 4분기에 시작되며, 2026년에 정식 출시될 예정입니다.
파일럿 또는 베타 파트너가 되고 싶다면 담당 계정 관리자에게 문의하세요.
Rapid /flights API 번들
빠른 항공편 API는 search-to-book 플로우를 활성화하는 다양한 엔드포인트로 구성되어 있습니다.
쾌속 항공편 엔드포인트에 대해 알아보기
이 제품은 아직 얼리 액세스 단계이므로 스키마 세부 사항과 기능은 아직 개발 중이며 파트너에게 정식 출시되기 전에 변경될 수 있다는 점을 염두에 두시기 바랍니다.
| 조치 | 메서드 | 휴식 URI | 결과 |
|---|---|---|---|
| 이용 가능한 항공편 검색 | POST | /flight-offers | 사용 가능한 오퍼를 반품합니다. |
| 항공편 혜택에 대한 자세한 정보 요청하기 | GET | /flight-offers/{offer_id} | 가격 내역 및 정책을 포함한 항공편의 세부 정보를 반환합니다. |
| 선택한 항공편의 좌석 배치도 요청하기 | GET | /flight-offers/{offer_id}/seats | 항공편의 좌석 배치도를 사용할 수 있는 경우 반환합니다. |
| 예약 시 선택한 결제 수단에 대한 세부 정보를 입력합니다. | POST | /결재 | 예약 생성 요청의 본문에 들어가는 payment_token 를 반환합니다. |
| 예약 완료 | POST | /일정/flight | 예약 세부 정보를 검색하거나 결제 세션을 완료할 수 있는 일정 ID와 링크를 반환합니다. |
| 기존 예약의 세부 정보를 일정 ID로 요청하세요. | GET | /일정/{itinerary_id}/flight | itinerary_id파라미터로 일정 세부 정보를 반환합니다. |
| 예약 취소 | 삭제 | /일정/{itinerary_id}/flight | 기존 예약을 취소합니다. |
사용 사례
빠른 항공편 API를 사용하여 고객을 위한 end-to-end 예약 환경을 만드는 방법은 다음과 같습니다.
1단계 - 이용 가능한 특가 항공권 검색
먼저 /flight-offers 엔드포인트를 사용하여 여행자가 이용 가능한 항공편을 확인할 수 있도록 합니다.
아래에서 주요 매개변수를 확인하세요:
| 주요 매개 변수 | 설명 | 예 |
|---|---|---|
departure_airport | 항공편이 출발하는 공항입니다. | LAS |
arrival_airport | 항공편이 도착하는 공항입니다. | LAX |
departure_date_time | 항공편이 출발하는 시간 및 날짜입니다. | 2025-01-09T17:45:00-08:00 |
2단계 - 이용 가능한 항공편 옵션에 대한 자세한 정보 제공
고객에게 항공편 옵션을 표시하기 전에 /flight-offers/{offer_id} 엔드포인트를 사용하여 좀 더 세분화된 정보를 얻으세요.
여행자가 예약하기 전에 알아두어야 할 세부 정보는 다음과 같습니다:
| 개체 | 다음 용도로 사용하세요... |
|---|---|
amenities | 사용 가능한 in-flight 엔터테인먼트 옵션(예: WiFi 또는 영화)을 표시합니다. |
baggage_allowance | 항공편에 포함된 수하물의 양에 대한 세부 정보를 입력하세요. |
change_policy | post-booking 변경이 허용되는지 여부와 허용되는 경우 추가 수수료가 발생하는지 여부를 표시합니다. |
meal_options | 비행 중 제공되는 음식과 음식이 포함되어 있는지 또는 추가 요금이 부과되는지 여부. |
3단계 - 고객이 선호하는 좌석 선택 지원
/flight-offers/{offer_id}/seats 엔드포인트를 사용하여 좌석 배치도를 표시(가능한 경우)하여 여행객이 선호하는 비행기 좌석을 선택할 수 있도록 합니다.
예시:
cabin_class: economy
exit_row_list:
- '17'
- '18'
rows:
- row_number: 16
seats:
- aisle: false
column: A
seat_number: 16A
availability: not_available
preferred: false
seat_codes:
- window
seat_token: Q11REWlbQV5VARNfBQBxQ14JXAVYTT1XEwtbXEcJUQpTAkBSR0sNFVUIZgVdFENZSxFqBwtRBlx9eDoSVgNGU0ZCQkFTbFFcRRJbF0BrAllcVAh5dTdDVlwVUURBTRRdbwBXR1JcAVMKAUlRBRUCWG1WDEACdg1XFlByBgRLA1wcBXEDABNwDFJbDRFBDA0BDFkOB1oNVA5Q4단계 - 결제
이제 /payments 엔드포인트를 사용하여 고객이 예약에 대한 결제 수단을 등록할 수 있습니다.
응답에는 예약 생성 요청의 본문에 포함된 payment_token 이 포함됩니다.
5단계 - 예약 만들기
/일정/flight 엔드포인트를 사용하여 예약을 완료하세요.
6단계 - 예약 세부 정보 검색
/일정/{itinerary_id}/flight 엔드포인트를 사용하여 일정 ID를 사용하여 예약 세부 정보를 검색할 수 있습니다. 응답에는 해당되는 경우 취소 링크가 포함됩니다.