항공권 예약 API 공급사 선택: API 뒤를 먼저 보라

후보 목록은 대개 그럴듯해 보입니다. 항공권 예약 API 공급사 세 곳, 저마다 깔끔한 REST 문서가 있고, 첫 주에 sandbox 키가 나오고, 시험해 본 노선마다 검색 endpoint가 운임을 돌려줍니다. 팀은 SDK가 가장 마음에 드는 곳을 고르고, 한두 번의 스프린트로 검색·가격 확인·예약을 만든 뒤 데모 일정을 잡습니다. 그러다 오픈 직전에 누군가 묻습니다. 그런데 항공권은 실제로 누가 발권하죠? 어떤 때는 답이 "우리"이고, 그러려면 회사에 없는 인가가 필요하거나 아무도 예산에 넣지 않은 보증금이 필요합니다. 어떤 때는 발권은 잘 되는데, 첫 환불 요청이 다른 시간대에 있는 지원 데스크로 보내는 이메일 한 통이라는 사실이 드러납니다.
이 중 어느 것도 문서에 없었습니다. 애초에 문서의 문제가 아니기 때문입니다. 항공권 예약 API 공급사를 고른다는 것은 대부분 API 뒤에 무엇이 서 있는지를 고르는 일입니다. 전자항공권이 누구의 발권 권한(ticketing authority)으로 나가는지, 누구의 돈이 언제 움직이는지, 그리고 항공권을 void·환불·재발행해야 할 때 누가 응답하는지. 검색, 가격 확인, 예약은 어디서나 비슷합니다. 팀들이 비교하는 것이 바로 그 부분이고, 정확히 그 부분이 서로 같습니다.
네 종류의 공급사가 같은 endpoint를 팝니다
밖에서 보면 모든 항공 API에는 검색 호출, 가격 또는 offer 호출, 예약 또는 order 호출, 그리고 발권에 이르는 어떤 경로가 있습니다. 그 호출들 뒤에는 서로 매우 다른 상업적 사슬이 있습니다. 후보 목록에는 대략 네 종류의 공급사가 올라오고, 경계는 흐릿합니다. 많은 회사가 동시에 두 종류에 속하기 때문입니다.
| 공급사 유형 | 누가 발권하나 | 판매 전에 필요한 것 | 돈의 흐름 | 발권 이후 |
|---|---|---|---|---|
| GDS 직접 연결 | 보통 귀사, 자체 발권 권한으로 | 대개 자체 인가와 발권 체계, 그리고 GDS와의 상업 계약 | 인가에 따라 주어지는 정산 제도로 항공사와 정산 (대부분의 시장에서 BSP) | 풍부한 서비스 명령이 있지만, 그것을 운용하는 것은 귀사 팀 |
| 항공사 NDC 채널 직접 연결 | 귀사, 또는 귀사와의 계약에 따라 항공사 | 항공사마다 따로, 한 곳씩 맺는 계약 | 항공사별 조건에 따름. 같은 정산 제도를 거칠 수도, 아닐 수도 있음 | 변경과 환불은 그 항공사가 구현한 범위까지. 항공사마다 다름 |
| GDS·NDC 콘텐츠 위의 aggregator | aggregator에 따라 다름: 귀사 권한으로, 또는 aggregator 자체 권한으로 | 물어보세요. 귀사 인가가 필요한 곳도, 아닌 곳도 있음 | 물어보세요. 예치금, 신용 한도, 또는 예약별 카드 결제 | 하나로 표준화된 인터페이스지만, 각 작업의 완성도는 뒤에 있는 소스만큼 |
| consolidator 또는 B2B 플랫폼 API | consolidator, 자체 발권 권한으로 | consolidator 계정. 귀사 자체 인가는 불필요 | consolidator에 둔 예치금 또는 신용 한도, 그쪽 조건으로 정산 | 플랫폼이 호출로 열어 둔 만큼. 일부 작업은 여전히 그쪽 데스크가 처리하는 요청일 수 있음 |
어느 칸이든 반박할 수 있고, 반박해야 합니다. 테이블 건너편에 앉은 공급사를 상대로요. 중요한 행은 기능 목록이 가장 긴 행이 아닙니다. 앞의 세 열이 지금 귀사의 모습을 그대로 설명하는 행입니다. 인가가 없는 스타트업이 인가를 전제로 하는 공급사와 계약했다면, SDK가 아무리 좋아도 잘못된 행 위에 지은 것입니다.
계약 전에 항공 API 공급사에게 물어볼 것
답은 문서 사이트에 거의 없습니다. 상업적 대화에서 나오고, 그것은 나쁜 신호가 아닙니다. 자기 권한으로 발권하는 공급사라면 귀사가 그 권한 위에서 판매하도록 허락하기 전에 귀사가 누구인지 알아야 하니까요. 무료 항공 API로 실제로 얻는 것에 관한 글은 더 좁은 논점을 다룹니다. 예약 가능한 재고 뒤에는 언제나 항공권을 책임지는 누군가가 있다는 것. 아래 질문들은 그 누군가를 찾아내기 위한 것입니다.
- 누구의 발권 권한으로 발권하나요? 귀사의 것이라면, 귀사 국가에서 어떤 인가와 보증금이 필요하고 받기까지 얼마나 걸리는지. 그쪽 것이라면, 항공사가 예약에서 보는 이름은 누구이고 고객이 보는 이름은 누구인지.
- 돈은 어떻게 보관되고 정산되나요? 선입금 예치금, 신용 한도, 또는 예약마다 카드 청구. 그리고 아무도 묻지 않는 후속 질문: 오후 네 시에 예치금이 바닥나면 들어오던 예약 요청은 어떻게 되나요?
- 발권 이후의 어떤 작업이 API 호출인가요? void, 환불, 교환, 항공사 스케줄 변경 처리, 이름 정정, 수하물이나 좌석 추가. 하나하나에 대해 endpoint인지, 사람이 처리하는 요청인지, 아예 제공하지 않는지 적어 두세요. "서비스 지원"에 대한 포괄적인 "예"가 아니라 작업 하나씩.
- 귀사의 판매 지점(point of sale)에서 본 커버리지는 어떤가요? 데모 노선이 아니라, 귀사의 주력 노선을 귀사 시장에서 검색한 결과를 요청하세요. 서울발 수요를 보는 회사와 유럽발 데모는 같은 결과가 아닙니다. 콘텐츠와 운임은 판매가 이뤄지는 곳에 따라 달라집니다.
- sandbox는 어디까지 가나요? 검색과 가격은 흉내 내기 쉽습니다. 테스트에서 hold, 발권, void, 환불까지 가는 sandbox라야 운영 환경에서 깨지는 절반을 시험하는 것입니다.
- 항공권이 이상한 상태에 빠지면 누가 받나요? 업무 시간이 귀사와 겹치는, 이름이 있는 데스크인가요, 아니면 티켓 대기열인가요?
사슬이 맞고 나서야 엔지니어링 질문이 의미를 갖기 시작합니다. 검색과 예약 사이에 움직이는 가격, PNR과 order의 차이, 예약이 생겼는지 알 수 없게 만드는 타임아웃. 이런 내용은 항공 API 문서가 말하지 않는 것에서 다뤘고, 여행 API 비교 글은 기술 축들을 서로 견주는 방법을 제시합니다. 표에서 행이 정해지기 전에는 둘 다 해 볼 가치가 없습니다.
이 플랫폼의 자리
저희는 API를 통해 항공 접근을 판매하므로, 저희 행을 솔직하게 밝힙니다. 플랫폼은 항공과 호텔 API를 제공합니다. 접근은 셀프서비스 키가 아니라 대화로 시작합니다. 첫 질문들이 위의 상업적 질문이고, 그 답은 회사마다 정해지기 때문입니다. 서비스는 tenant별로 활성화됩니다. 플랫폼에는 consolidator 계정이 있고, 하위 에이전트 신용 한도와 정산 청구는 스프레드시트가 아니라 시스템의 기본 개념입니다.
이 페이지에는 항공사 커버리지나 가격을 공개하지 않습니다. 둘 다 귀사의 시장과 판매 지점에 달려 있어서, 여기 적힌 숫자는 대부분의 독자에게 틀린 숫자가 됩니다. 위 목록을 저희에게 직접 던져 보고 싶다면 여행 API 페이지에서 시작하세요.
문서만 보고 고를 때 치르는 비용
두 가지 결과, 둘 다 비쌉니다. 치르는 화폐가 다를 뿐입니다.
첫째는 작동하지만 팔 수 없는 연동입니다. sandbox에서는 검색, 가격, 예약이 모두 통과합니다. 운영 환경에서는 귀사 시장에서 예약을 발권할 수 없습니다. 공급사가 전제한 발권 체계가 귀사 쪽에 존재하지 않기 때문입니다. 코드는 끝났고, 첫 질문이었어야 할 서류를 기다립니다. 그리고 서류에는 서류만의 일정이 있습니다.
둘째는 더 조용하고 더 오래갑니다. 발권이 되고, 제품이 출시되고, 고객이 옵니다. 그 뒤로 모든 void, 모든 환불, 모든 스케줄 변경이 공급사 데스크와의 이메일 스레드가 됩니다. 그래서 지원 인력은 매출과 함께 늘어나고, 항공권당 마진은 그만큼 줄어듭니다. API가 완전해 보였던 것은 순조로운 경로(happy path)가 완전했기 때문입니다. 환불을 데모하는 사람은 없습니다.
두 실패 모두 개념 증명(proof of concept)에서는 드러나지 않습니다. 둘 다 실제 고객을 맞는 첫 달에 드러납니다. 그러니 문서는 마지막에 읽으세요. 사슬을 먼저 그리세요. 누가 발권하고, 누가 누구에게 돈을 내고, 누가 무엇을 처리하는지. 사슬이 지금의 귀사와 맞는 공급사를 고르고, 그다음에야 SDK를 두고 논쟁하세요.