본문으로 건너뛰기
블로그

무료 항공 API: 세 가지 중 실제로 필요한 것은 무엇인가

Tekravel 편집팀
AI의 도움을 받아 작성됨

주말 하루, 아이디어 하나, 예산은 없는 상태라서 검색창에 그 단어를 입력했을 겁니다. 운임 하락 알림 봇일 수도 있고, 작은 커뮤니티를 위한 여행 플래너일 수도 있고, 명절마다 가족이 타는 노선을 위한 예약 사이트일 수도 있습니다. 결과는 꽤 후해 보입니다. 무료 플랜과 가입 양식을 갖춘 업체가 줄줄이 나오고, 몇 분이면 메일함에 키가 도착합니다. 그런데 개발을 며칠 진행하고 나서야, 연동한 것이 제품이 약속한 단 하나의 일을 할 수 없다는 사실을 알게 됩니다.

이런 일이 생기는 이유는 무료 항공 API가 하나의 범주가 아니기 때문입니다. 이 검색어는 서로 다른 세 종류의 제품을 보여주고, 그중 항공권을 팔 수 있게 해주는 것은 하나뿐입니다. 첫 요청을 작성하기 전에 지금 보고 있는 것이 어느 종류인지 아는 것만으로 일주일을 아낄 수 있습니다.

"무료 항공 API"에 응답하는 세 가지

마케팅 문구를 걷어내면 거의 모든 결과가 다음 중 하나에 들어갑니다.

유형호출하면 돌아오는 것일반적인 무료 제공 범위항공권을 팔 수 있나돈은 누가 책임지나
운항 상태·스케줄 데이터출발, 도착, 지연, 게이트, 시간표, 때로는 과거 위치흔함: 호출 한도가 있는 무료 플랜이나 체험 키아니요. 응답에 운임도 좌석도 없습니다아무도 없습니다. 정보일 뿐입니다
검색 후 이동형(affiliate)메타서치 인덱스의 가격과 다른 회사 결제 화면으로 가는 딥링크흔함: 가입은 무료, 클릭이 예약으로 이어지면 수수료로 정산아니요. 여행자는 제휴사 사이트에서 예약하고 결제합니다제휴사 사이트. 클릭이 예약으로 이어지면 당신이 수수료를 받습니다
예약 가능한 재고검색, 가격 확인, 홀드, 주문, 전자항공권 발권까지 가능한 실시간 오퍼대개 샌드박스까지. 운영 환경은 계약과 함께 옵니다예. 그게 핵심입니다발권하는 쪽이 자기 인가 아래에서

진짜 차이는 마지막 열에 있습니다. 앞의 두 유형은 호출해도 누구의 돈도 위험에 처하지 않기 때문에 무료일 수 있습니다. 세 번째는 그럴 수 없고, 그 이유는 업체가 얼마나 너그러운지와 아무 상관이 없습니다.

운항 상태 데이터는 유용하지만 예약 상품은 아니다

항공편 데이터 API는 실제로 존재하는 항공편에 대한 질문에 답합니다. 인천에서 출발하는 저녁 편이 정시에 뜨는지, 몇 번 게이트인지, 다음 달 이 노선 시간표가 어떤지 같은 것들입니다. 지연 알림, 공항 안내 화면, 기업 출장 대시보드, 지연 보상 청구 서비스에는 알맞은 도구입니다. 가격이 붙는 일에는 맞지 않는 도구입니다. 개발자가 스케줄 데이터로 그럴듯한 검색 화면을 만들고 "예약" 버튼을 붙인 다음에야 운임이 어디서 오는지 묻는 경우가 있습니다. 거기서 오지 않습니다.

제휴 검색도 사업이다, 다만 당신이 통제하는 사업은 아니다

이동형은 대부분이 떠올리는 모습에 더 가깝습니다. 출발지, 도착지, 날짜를 보내면 가격과 링크가 돌아옵니다. 여행자가 클릭하면 당신의 사이트를 떠나 제휴사 결제 화면에서 예약하고, 예약이 완료되면 몇 주 뒤 당신이 수수료를 받습니다.

실제로 사업이 될 수 있고, 이걸로 운영되는 콘텐츠 사이트도 많습니다. 다만 무엇을 포기하는지는 분명히 알아야 합니다. 화면에 보여주는 가격은 보통 캐시된 인덱스에서 오기 때문에, 클릭 후 여행자가 보는 가격과 다를 수 있습니다. 고객의 이름, 이메일, 예약 번호는 제휴사의 것이지 당신의 것이 아닙니다. 마진을 얹을 수도, 호텔을 묶어 팔 수도, 자체 결제 수단을 제공할 수도, 항공편이 취소됐을 때 전화를 받을 수도 없습니다. 당신 쪽에는 바꿀 수 있는 것이 아무것도 없기 때문입니다. 당신은 트래픽을 보내고 있고, 트래픽이 곧 상품입니다.

원하는 것이 자기 고객과 자기 마진을 가진 여행 브랜드라면, 이 유형은 한 달쯤은 괜찮아 보이다가 곧 천장이 됩니다.

예약 가능한 재고가 발권 단계에서 절대 무료일 수 없는 이유

검색과 가격 확인은 읽기 작업입니다. 발권은 금융 행위입니다. 누군가는 IATA 발권 인가(또는 항공사와의 직접 계약)를 갖고 그 아래에서 전자항공권을 발행하고, BSP나 항공사 자체 채널로 대금을 정산해야 합니다. 그 순간부터 그 주체는 고객의 결제가 성공하든 실패하든 항공사에 항공권 대금을 빚지게 됩니다.

사기는 바로 거기에 떨어집니다. 도난 카드로 결제된 예약은 발권한 쪽이 이미 대금을 치른 항공권이고, 몇 주 뒤의 chargeback은 결제를 받은 쪽에서 돈을 다시 가져갑니다. 허술한 자동화로 어긴 운임 규정은 인가 보유자 앞으로 ADM(agency debit memo)이 되어 돌아옵니다. 그래서 인가 보유자는 당신의 코드가 버튼을 누르기 전에 누가, 어디서, 어떤 통제 장치를 갖고 예약을 보내는지 알고 싶어 합니다. 그 검토가 바로 계약이고, "무료"가 샌드박스에서 멈추는 이유입니다.

그렇다고 작은 팀이 예약형 API에 닿을 수 없다는 뜻은 아닙니다. 비용이 어딘가에서 나타난다는 뜻입니다. 예약 건당 수수료, 제공받는 넷 운임에 포함된 마진, 보증금, 또는 그 안에서 운영해야 하는 신용 한도 같은 형태로요. 어느 쪽인지 일찍 물어보세요. 발권 후 돈이 어떻게 움직이는지 설명하지 못하는 업체는 그 문제를 아직 끝까지 생각해 보지 않은 겁니다.

계약 전에 샌드박스에서 할 수 있어야 하는 것

좋은 샌드박스는 예약형 API의 무료 부분이고, 연동이 사업 논의를 할 가치가 있는지 판단하기에 충분해야 합니다. 무엇에든 서명하기 전에 다음이 가능한지 확인하세요.

  1. 실제 노선을 검색한다. 미리 준비된 응답 하나가 아니라요. 저비용항공사가 가득한 단거리 노선과 장거리 노선을 하나씩 시도해 보고, 콘텐츠가 예상대로 다르게 나오는지 보세요.
  2. 가격을 확인하고 다시 확인한다. 검색 결과의 오퍼로 가격을 확인하고, 잠시 기다렸다가 다시 확인합니다. 오퍼가 얼마나 오래 유효한지, 가격이 바뀌었을 때 응답이 어떤 모습인지 알아두세요.
  3. 발권 없이 홀드한다. 좌석은 잡되 발권하지 않는 예약을 만들고, 발권 기한을 읽은 다음 취소합니다. 샌드박스가 검색만 허용한다면 쉬운 절반만 평가하고 있는 셈입니다.
  4. 일부러 망가뜨린다. 항공사가 거부할 문자가 들어간 이름, 성인 없는 유아, 이미 지난 날짜를 보내 보세요. 읽을 수 있는 오류는 어떤 기능 목록보다 값집니다.
  5. 예약 이후 호출을 확인한다. 취소, void, 환불이 API에 있는지 아니면 고객지원 창구를 거쳐야 하는지. 첫 실제 고객이 묻기 전에 알아야 합니다.

샌드박스가 절대 보여주지 않는 것도 있습니다. 실제 좌석 소진, 항공사의 스케줄 변경, 정산입니다. 무엇을 흉내 내도 되고 무엇은 절대 흉내 내면 안 되는지 다룬 더 자세한 샌드박스 테스트 계획과, 그 단계를 넘어설 때를 위한 전체 예약 흐름 안내를 함께 참고하세요.

이 플랫폼의 위치

솔직히 말하면, 이 플랫폼은 항공과 호텔 API를 제공하며 둘 다 예약 가능한 유형입니다. 접근은 셀프서비스 키가 아니라 대화로 시작합니다. 해커톤을 끝내려고 오늘 밤 당장 키가 필요하다면 저희는 맞지 않고, 그 사실을 가입 양식보다 이 문단에서 먼저 아는 편이 낫습니다.

대화에서는 위의 질문들을 다룹니다. 무엇을 만들고 있는지, 발권이 필요한지 아니면 검색과 가격 확인만 필요한지, 어느 시장에서 판매하는지, 예약 대금은 어떻게 결제되는지. 그 답에 따라 보게 될 콘텐츠와 정산 방식이 정해집니다. 지금 그 단계라면 여행 API 페이지에서 시작하면 됩니다.

잘못된 유형을 고르면 치르는 비용

비싼 실수는 API에 돈을 내는 것이 아닙니다. 잘못된 유형 위에 제품을 만들고, 그 사실을 중요한 사람 앞에서 알게 되는 것입니다.

흔히 이렇게 흘러갑니다. 데모는 무료이고 빨랐다는 이유로 제휴 피드나 스케줄 데이터 위에서 돌아갑니다. 검색 화면은 완성된 것처럼 보입니다. 투자자, 파트너 여행사, 혹은 첫 실제 고객이 예약해 보겠다고 하고, 할 수 있는 정직한 대답은 버튼이 사이트 밖으로 나가거나 아무 일도 하지 않는다는 것뿐입니다. 그때부터 재구축이 시작되는데, 이건 업체 교체보다 큽니다. 제휴 결과에는 가격을 확인할 오퍼 ID도, 홀드도, 탑승객 모델도 없기 때문에, 검색 화면 뒤의 코드가 호출하는 API와 함께 바뀌어야 합니다.

한 예약형 업체에서 다른 업체로 옮겨 본 팀은 같은 교훈의 순한 버전을 압니다. 셀프서비스 항공 API 교체하기에서 다뤘습니다. 더 싼 길은 표의 마지막 열부터 정하는 것입니다. 제품이 항공권 대금을 받아야 한다면 첫 주에 예약형 API 논의를 시작하고 그 샌드박스 위에서 데모를 만드세요. 무료 옵션이 더 예쁜 화면을 더 빨리 줄 수 있었다 해도 말입니다.

Tekravel 편집팀

여행 기술 데스크

Tekravel 여행 기술 데스크는 업계 독자를 위해 씁니다. 여행사 대표, 콘솔리데이터, 그리고 이들을 연동하는 개발자입니다. 모든 기사는 공개 전에 해당 기사가 다루는 플랫폼에서 확인합니다.