항공 API

검색부터 발권까지, 항공 예약의 처음과 끝

여러 소스의 실시간 요금을 검색하고, 가격을 재검증하고, 예약한 뒤 발권하세요. 하나의 REST 엔드포인트 세트, 가격은 USD로 제공됩니다.

POST /Air/AirLowFareSearch

{
  "AdultCount": 1,
  "TravelPreference": { "CabinType": 3 },
  "OriginDestinationInformations": [
    { "OriginLocationCode": "TBS",
      "DestinationLocationCode": "DXB",
      "DepartureDateTime": "2026-11-14T00:00:00" }
  ]
}

개요

항공사 콘텐츠는 파편화되어 있고 소스마다 형식이 제각각입니다. 이 항공 예약 API는 검색, 운임 규정, 수하물, 예약, 발권, 환불을 하나의 일관된 JSON 계약으로 통합합니다.

엔드포인트 뒤에는 글로벌 배급 시스템과 저비용 항공사를 하나의 JSON 계약으로 연결하는 정규화된 요금 엔진이 있습니다. 콘텐츠가 GDS에서 오든 항공사 직접 연동에서 오든 일관된 여정, 요금 규칙, 수하물, 좌석 데이터를 받으므로, 항공 예약 앱이나 OTA는 한 번 연동해 어디서나 확장됩니다.

제공 기능

항공 그룹별 최저가 일정을 검색하거나, 서버 전송 이벤트(SSE)로 결과를 스트리밍해 빠르게 첫 화면을 그리세요.

예약 직전에 요금을 재검증하여, 청구하는 가격과 실제 가격이 일치하도록 합니다.

전체 라이프사이클을 직접 관리하세요. 좌석 홀드, 발권, 이후 조회·취소·환불까지.

느린 노선에서도 빠른 첫 렌더링을 위해 server-sent events로 여정을 스트리밍합니다.

완전한 발권 후 처리: 서류 조회, 기간 내 보이드, 취소, 환불.

흐름은 이렇게 동작합니다

Search

Post routes and dates, get priced itineraries back, or stream them over server-sent events.

Revalidate

Re-price the chosen itinerary right before booking so the fare you charge is the fare you get.

Book

Create the booking, hold the seats, and receive a booking reference.

Issue

Issue the ticket against your balance, then track, void, cancel, or refund.

주요 엔드포인트

POST/Air/AirLowFareSearchSearch the cheapest itinerary per flight group.

POST/Air/AirLowFareSearchStreamStream itineraries over server-sent events.

POST/Air/AirRevalidateRe-price and validate an itinerary before booking.

POST/Air/AirBookCreate the booking and hold seats.

POST/Air/AirTicketIssue the ticket for a booking.

GET/Air/AirBookingDetailsRetrieve a booking, its status, and documents.

요청과 응답

Request · POST /Air/AirLowFareSearch

{
  "AdultCount": 1,
  "TravelPreference": { "CabinType": 3 },
  "OriginDestinationInformations": [
    { "OriginLocationCode": "TBS",
      "DestinationLocationCode": "DXB",
      "DepartureDateTime": "2026-11-14T00:00:00" }
  ]
}

Response · 200 OK

{
  "itineraries": [
    {
      "fareCode": "TBSDXB-Y-412",
      "total": { "amount": 412.00, "currency": "USD" },
      "seatsRemaining": 5,
      "segments": [
        { "from": "TBS", "to": "DXB",
          "depart": "2026-11-14T09:40",
          "carrier": "EK", "flight": "2201" }
      ]
    }
  ]
}

응답에 포함되는 것

fareCode: Opaque identifier you pass to revalidate and book.
total: Final price with currency, already normalized to USD.
seatsRemaining: Bookable seats left at this fare.
segments: Each flight leg with carrier, flight number, times, and airports.
baggage: Included allowance and paid options per segment.

1,000+

항공사