빠른 비행 API 파일럿 문서
얼리 액세스 미리 보기
이 문서는 일부 파트너에게만 제공되는 얼리 액세스 미리 보기 이니셔티브의 일부입니다. 파일럿 프로그램은 2025년 4분기에 시작되며, 2026년에 정식 출시될 예정입니다.
파일럿 또는 베타 파트너가 되고 싶다면 담당 계정 관리자에게 문의하세요.
항공편 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를 사용하여 예약 세부 정보를 검색할 수 있습니다. 응답에는 해당되는 경우 취소 링크가 포함됩니다.