항공권 API 연동
여행사와 OTA를 위한 항공권 API: 검색, 예약, 발권까지
항공권 API를 사용하면 웹사이트에서 항공사의 실시간 운임을 보여주고 실제 예약을 생성할 수 있습니다. 이 페이지에서는 API 호출 방식, 항공 콘텐츠의 출처, 서비스 오픈 전에 체결해야 할 계약, 그리고 PHPTRAVELS가 하나 또는 여러 항공권 API를 자사 도메인의 완전한 예약 엔진으로 만드는 방법을 설명합니다.
- GDS, NDC, 콘솔리데이터
- 검색부터 발권, 환불까지
- 기본 제공 커넥터
- 자체 REST API
개요
항공권 API가 실제로 하는 일
항공권 API는 항공사, GDS 또는 콘솔리데이터가 여행 판매사에 제공하는 웹 서비스 모음입니다. 시스템이 노선, 날짜, 승객 정보를 요청으로 보내면 운임이 포함된 오퍼를 받습니다. 여행자가 하나를 선택하면 이후 호출로 가격을 확정하고, 예약을 생성하고, 항공권을 발권합니다.
API 호출은 여정의 흐름을 따릅니다. 명칭은 공급사마다 다르지만 모든 항공권 API는 같은 5단계를 다루며, 대부분의 공급사가 현재 사용하는 메시지 이름은 IATA의 NDC 표준에서 정의합니다.
API는 데이터만 주고받습니다. 검색 폼, 결과 페이지, 결제, 인보이스, 판매 이후 팀이 처리하는 사후 관리는 예약 플랫폼의 역할이며, 여기서 항공권 예약 소프트웨어이 필요합니다.
- 01
검색AirShopping
출발지, 도착지, 날짜, 좌석 등급, 승객 수를 보내고 운임, 세금, 수하물, 운임 브랜드가 포함된 오퍼를 받습니다.
- 02
운임 확인OfferPrice
선택한 오퍼를 공급사에 다시 확인합니다. 운임은 수시로 바뀌므로 이 호출로 여행자가 지불할 금액을 확정합니다.
- 03
예약OrderCreate
승객 이름, 연락처, 여행 서류를 보냅니다. 공급사가 예약(PNR 또는 NDC 오더)을 생성하고 좌석을 확보합니다.
- 04
발권OrderChange · payment
결제 후 예약이 전자항공권으로 발권되며, 승객별·비행 쿠폰별로 항공권 번호가 부여됩니다.
- 05
사후 관리OrderRetrieve · OrderCancel
운임 규정에 따라 예약 재조회, 날짜 변경, 수하물·좌석 추가, 취소, 보이드, 환불을 처리합니다.
운임의 출처
세 가지 항공권 API, 세 가지 판매 방식
계약할 수 있는 모든 항공권 API는 세 그룹 중 하나에 속합니다. 콘텐츠, 계약 가능 대상, 발권 주체가 각각 다르기 때문에 대부분의 여행사는 둘 이상을 함께 사용합니다.
| GDS API | NDC API | 콘솔리데이터 API | |
|---|---|---|---|
| 개요 | Amadeus, Sabre, Travelport: 한 번의 연결로 수백 개 항공사의 공시 운임에 접근. | IATA NDC 표준을 통한 항공사 자체 오퍼. 직접 또는 애그리게이터를 통해 연결. | GDS, NDC, LCC 콘텐츠를 자체 넷 운임으로 재판매하는 도매 업체. |
| 콘텐츠 | 대형 항공사와 브랜드 운임. LCC 커버리지는 GDS에 따라 다릅니다. | 항공사의 가장 풍부한 오퍼: 번들, 부가 서비스, 다이내믹 프라이싱. | LCC와 비공시 운임을 포함해 가장 폭넓은 구성인 경우가 많습니다. |
| 계약 가능 대상 | 보통 GDS 계약을 보유한 인증 여행사(IATA, ARC 또는 현지 동등 자격). | 항공사나 애그리게이터가 승인한 여행사. 신규 사업자를 받는 애그리게이터도 있습니다. | 자체 인증이 없는 곳을 포함한 대부분의 여행사와 OTA. |
| 발권 | 여행사가 자체 인증으로 직접 발권합니다. | 항공사가 발권하며, 오더는 애그리게이터 또는 IATA BSP를 통해 정산됩니다. | 콘솔리데이터가 자체 인증으로 대신 발권합니다. |
| 정산 | BSP 또는 ARC를 통해 정산. 커미션과 인센티브는 계약에 따라 다릅니다. | 항공사 가격과 수수료. 일부 항공사는 NDC가 아닌 예약에 추가 요금을 부과합니다. | 예치금이나 신용 한도에서 콘솔리데이터의 넷 운임을 지불하고 마크업을 더합니다. |
| PHPTRAVELS 지원 | Amadeus, Sabre, Travelport | Duffel | TBO, PKfare, Kiwi, AERTiCKET 외 |
어떤 것이 맞을지 모르겠다면, 콘솔리데이터로 첫날부터 판매를 시작하고, 인증을 받은 뒤 GDS를 추가하고, 최고의 오퍼를 NDC로 제공하는 항공사에는 NDC를 추가하세요. 자세한 내용은 여행사용 GDS 시스템 및 NDC 항공 예약 시스템 가이드를 참고하세요.
호출의 내부
단계별로 항공권 API가 주고받는 데이터
플랫폼이 보내고 받는 데이터를 단순화해 보여줍니다. 실제 공급사는 자체 필드 이름과 훨씬 긴 메시지를 사용하지만, PHPTRAVELS는 이를 모두 동일한 예약 모델로 매핑합니다.
1POST /flights/search 2{ 3 "from": "DXB", "to": "LHR", 4 "date": "2026-11-14", 5 "cabin": "economy", 6 "passengers": { "adults": 2 } 7}
1{ 2 "offers": [{ 3 "id": "OF-7Q2K", 4 "carrier": "EK", "flight": "EK001", 5 "depart": "07:45", "arrive": "11:35", 6 "fare_family": "Standard", 7 "bags": "1 x 23 kg", 8 "total": { "amount": 1284.60, "currency": "USD" }, 9 "expires": "2026-10-09T12:20:00Z"10 }, …]11}
오퍼에는 유효 기간이 있습니다. 대부분의 공급사는 오퍼마다 시간 제한을 두며, 이후에는 다시 검색하거나 운임을 재확인해야 합니다.
1POST /flights/price 2{ "offer_id": "OF-7Q2K" }
1{ 2 "offer_id": "OF-7Q2K", 3 "available": true, 4 "total": { "amount": 1284.60, "currency": "USD" }, 5 "fare_rules": { 6 "change": "fee + fare difference", 7 "refund": "not refundable" 8 } 9}
운임이 바뀌었다면 이전 운임으로 예약하지 않고 결제 전에 새 가격을 보여줍니다.
1POST /flights/book 2{ 3 "offer_id": "OF-7Q2K", 4 "passengers": [{ 5 "type": "adult", 6 "given_name": "SARA", "surname": "KHAN", 7 "born": "1990-04-02", "passport": "…" 8 }, …], 9 "contact": { "email": "…", "phone": "…" }10}
1{ 2 "booking_ref": "6XK2PL", 3 "status": "held", 4 "ticket_time_limit": "2026-10-10T18:00:00Z" 5}
이름은 여권과 일치해야 합니다. 많은 항공사가 이름 변경에 수수료를 부과하거나 아예 허용하지 않습니다.
1POST /flights/ticket 2{ "booking_ref": "6XK2PL", "payment": "…" }
1{ 2 "booking_ref": "6XK2PL", 3 "status": "ticketed", 4 "tickets": [ 5 { "passenger": 1, "number": "176-2400000001" }, 6 { "passenger": 2, "number": "176-2400000002" } 7 ] 8}
발권 전 보류 중인 예약은 발권 기한이 지나면 자동으로 취소됩니다.
설명용 예시 데이터(단순화)
PHPTRAVELS 기본 제공
자체 키로 바로 켜는 항공권 API 커넥터
아래 항공권 공급사는 PHPTRAVELS 항공 모듈에 이미 연결되어 있습니다. 공급사와 계약하고, 관리자 화면에 인증 정보를 입력하고, Sandbox에서 테스트한 뒤 서비스를 오픈하면 됩니다. 목록은 연동 디렉터리의 실시간 정보입니다.
Seeru
Amadeus연동 가이드
Duffel연동 가이드
Google Flights연동 가이드
Kayak
Kiwi연동 가이드
Mystifly
PKfare연동 가이드
Sabre연동 가이드
TBO Holidays연동 가이드
Travelport연동 가이드- 모든 연동
원하는 공급사가 없나요? 문서가 있는 항공권 API라면 무엇이든 추가할 수 있으며, 소스 코드는 고객의 소유입니다. 맞춤형 API 연동 또는 전체 여행 XML API 공급사 목록를 확인하세요.
첫 예약 전에
API 외에 필요한 것
기술적인 연결은 금방 끝납니다. 공급사가 계정을 운영 환경으로 전환하기 전에 요구하는 항목은 다음과 같습니다.
공급사 계약
모든 항공권 API는 GDS, 항공사, 애그리게이터 또는 콘솔리데이터와의 계약이 필요합니다. 인증 정보는 계약과 함께 발급되며, 소프트웨어 업체가 제공하지 않습니다.
인증 또는 발권 파트너
직접 발권하려면 IATA, ARC 또는 현지 동등 자격이 필요합니다. 자격이 없다면 콘솔리데이터가 대신 발권합니다.
인증 테스트
대부분의 공급사는 운영 환경 접근 권한을 주기 전에 Sandbox에서 예약 흐름(검색, 예약, 발권, 취소)을 테스트합니다.
공급사 결제 수단
BSP 또는 ARC 정산, 콘솔리데이터 예치금, 또는 항공사가 직접 청구하는 카드 결제.
운임 규정과 정책
공급사의 운임 규정에 따른 변경, 환불, 수하물 조건을 사이트에 명확히 안내해 여행자가 구매 내용을 알 수 있도록 합니다.
예약 사후 관리 담당자
스케줄 변경, 이름 정정, 보이드, 환불은 판매 후에도 계속 발생합니다. 누가 처리할지 미리 정해 두세요.
API와 예약 엔진의 차이
API는 운임을, 플랫폼은 매출을 만듭니다
항공권 API를 웹사이트에 바로 연결해도 작업의 대부분은 그대로 남습니다. 공급사 API가 제공하는 것과 PHPTRAVELS가 더하는 것은 다음과 같습니다.
항공권 API가 제공하는 것
- 노선과 날짜별 오퍼와 운임
- 운임 확인과 운임 규정
- 예약 번호(PNR 또는 오더)
- 발권 후 항공권 번호
- 변경 및 취소 호출
PHPTRAVELS가 더하는 것
- 원하는 언어로 된 검색 폼, 결과, 필터, 결제 화면
- 여러 공급사 동시 검색과 중복 항목 통합
- 마크업, 커미션, B2B 에이전트 지갑
- 자체 결제 게이트웨이를 통한 카드 결제
- 여행자 언어로 된 전자항공권, 인보이스, 이메일
- 관리자 화면의 예약 큐, 보이드, 환불, 재발권
각 부분이 어떻게 작동하는지 기능별로 항공 페이지에서 확인해 보세요.
개발자용
모든 공급사 위에 구축하는 자체 항공권 API
PHPTRAVELS는 연결된 모든 항공권 공급사를 하나의 예약 모델로 정규화합니다. 모바일 앱, 파트너, 백오피스 도구는 공급사별 API 대신 하나의 REST API와 통신하면 됩니다.
REST API와 문서는 Enterprise 플랜에 포함됩니다. 가격에서 플랜을 비교하거나 개발자 문서를 확인하세요.
- 모든 공급사에 동일한 형식GDS, NDC, 콘솔리데이터의 오퍼가 같은 구조로 제공되므로 앱에서 공급사별 형식을 처리할 필요가 없습니다.
- Webhook예약, 발권, 취소 이벤트가 발생 즉시 고객의 시스템으로 전송됩니다.
- 소스 코드 포함전체 소스 코드가 포함된 설치형이므로 개발자가 API를 확장하거나 공급사를 추가할 수 있습니다.
더 읽어보기
항공권 API 가이드
항공권 API는 여행 웹사이트가 항공 운임 검색, 가격 확인, 예약 생성, 발권을 실시간으로 처리할 수 있게 해 주는 웹 서비스 모음입니다. GDS, 항공사(NDC를 통해), 콘솔리데이터가 각각 제공합니다.
일부 업체는 테스트용 무료 Sandbox를 제공하고, 일부 메타서치 API는 예약 없이 가격만 제공합니다. 하지만 항공권을 판매하려면 반드시 GDS, 항공사, 애그리게이터 또는 콘솔리데이터와 상업 계약이 필요합니다.
항상 그렇지는 않습니다. GDS를 통해 직접 발권하려면 인증이 필요합니다. 인증이 없어도 콘솔리데이터 API로 판매할 수 있으며, 콘솔리데이터가 자체 인증으로 발권합니다.
보통은 콘솔리데이터입니다. 인증이 없는 여행사도 받아주고 LCC도 포함하기 때문입니다. 판매량이 늘면 GDS나 NDC 연결을 추가하세요.
GDS API는 한 번의 연결로 여러 항공사의 공시 운임을 제공합니다. NDC API는 항공사 자체 오퍼를 번들과 부가 서비스와 함께 IATA NDC 형식으로, 직접 또는 애그리게이터를 통해 제공합니다.
네. PHPTRAVELS는 연결된 모든 항공권 공급사를 동시에 검색하고 중복 항공편을 통합해 최저 운임을 남기므로, 여행자는 하나의 목록만 보게 됩니다.
아니요. 각 공급사와 직접 계약하고 자체 인증 정보를 관리자 화면에 입력합니다. PHPTRAVELS는 예약 플랫폼과 기본 제공 커넥터를 제공합니다.
기본 제공 커넥터를 사용하면 기술 설정은 인증 정보 입력과 테스트로 끝납니다. 대부분의 시간은 공급사가 주도하는 계약과 인증 테스트에 소요됩니다.
네. Enterprise 플랜에서는 PHPTRAVELS REST API가 연결된 모든 공급사의 검색과 예약을 하나의 형식으로 제공하며, 예약 이벤트용 Webhook도 지원합니다.