Amadeus Self Service API 대안: 일주일 만에 이전하기

알게 되는 계기는 실패한 헬스 체크이거나, 사용자의 연락입니다. 첫 프로토타입부터 호출해 온 검색 엔드포인트가 한 번도 본 적 없는 오류를 돌려주고, 키를 관리하던 포털은 더 이상 존재하지 않습니다. 지금 Amadeus Self Service API 대안을 찾고 있다면, 아마 바로 그 상황에 있을 것입니다. 잘 돌아가는 제품이 있고, 코드는 한 공급사의 요청 형식에 맞춰 짜여 있으며, 검색이 망가졌다는 걸 사용자가 알아차리기까지 남은 시간은 짧습니다.
이 공급사에 대해 말할 가치가 있는 사실은 하나뿐이고, 이 글도 그 하나만 말합니다. Amadeus는 2026년 7월 17일 Self-Service API 포털을 종료했고, 신규 개발자는 계약 기반으로 운영되는 Enterprise 채널로 안내됩니다. 이 글에서 그 이야기는 여기까지입니다. 정말 쓸모 있는 질문은 무엇으로 대체할지, 그리고 아직 잘 돌아가는 부분을 다시 만들지 않고 약 일주일 안에 어떻게 옮겨 갈지입니다.
셀프서비스가 실제로 주던 것
옛 포털을 "항공권 API 하나"로 기억하고 다른 항공권 API를 찾아 나서기 쉽습니다. 하지만 그러면 두 명짜리 스타트업이나 주말 프로젝트에게 그것이 왜 유용했는지를 놓치게 됩니다. 대체로 세 가지였습니다.
- 오후 한나절이면 닿는 테스트 환경. 가입하고, 키를 받고, 검색을 호출했습니다. 회사가 무슨 일을 하는지 묻는 사람은 없었습니다.
- 쓴 만큼 내는 요금. 호출한 만큼만 냈으니, 사용자가 백 명인 제품에는 사용자 백 명만큼의 비용만 들었습니다.
- 영업 절차가 없음. 코드를 쓰기 전에 누군가의 승인을 받을 필요가 없었습니다.
엔터프라이즈 계약은 이 세 가지를 모두 뒤집습니다. 접근은 상업적 협의 뒤에 오고, 가격은 협상으로 정해지며, 테스트 환경은 서류 절차가 끝나야 도착합니다. 판매자 입장에서 보면 무리한 일은 아닙니다. 항공사 콘텐츠를 유통하는 데에는 실제 의무가 따르기 때문입니다. 하지만 이것은 여러분의 계획을 바꿉니다. API 키 하나를 다른 키로 바꾸면 된다고 생각했다면, 솔직히 말해 제대로 된 대안 대부분은 더 이상 그렇게 동작하지 않습니다. 이 사이트가 제공하는 것도 마찬가지입니다. 이에 대해서는 아래에서 더 이야기합니다.
Amadeus Self Service API 대안으로 가는 세 가지 경로
공급사 이름을 걷어 내면 대안은 세 종류뿐입니다. 차이는 JSON의 모양보다는 누구와 계약하는지, 그리고 결국 누가 항공권을 발권하는지에 있습니다.
| 경로 | 첫 실제 예약까지 걸리는 시간 | 기대할 수 있는 콘텐츠 | 발권 자격을 가진 쪽 |
|---|---|---|---|
| GDS 직접 계약 | 가장 김: 상업 검토, 인증, 그다음에 개발 | 폭넓은 GDS 콘텐츠. NDC와 저비용항공은 맺는 계약에 따라 다름 | IATA 인가를 가졌다면 여러분. 아니라면 인가를 가진 누군가가 여전히 필요 |
| 애그리게이터 API | 중간: 온보딩은 가볍지만 계약은 예상해야 함 | GDS, NDC, 저비용항공의 조합. 애그리게이터가 어떤 소스를 연결했는지에 따라 다름 | 보통 애그리게이터, 또는 그 발권 파트너 |
| 콘솔리데이터의 API | 발권된 항공권까지 가장 짧은 길인 경우가 많음. 발권이 이미 해결되어 있으므로 | 콘솔리데이터가 파는 모든 것: 계약 운임과 넷 운임, 그리고 공급처가 제공하는 것 | 콘솔리데이터가 자체 인가로 발권 |
가운데 열에 동의하지 않아도 되고, 여러분의 경우라면 직접 따져 봐야 합니다. 이미 인가를 갖고 있고 상업 담당자가 있는 팀이라면 GDS 경로가 표보다 빠르다고 느낄 수도 있습니다. 하지만 셀프서비스 샌드박스 위에 제품을 만든 개발자 대부분은 발권 자격을 가져 본 적이 없고, 바로 마지막 열이 이전 후에 제품의 얼마만큼이 여전히 작동하는지를 결정합니다.
이유는 이렇습니다. 검색과 가격 조회는 읽기 작업이라 세 경로 어디서든 얻을 수 있습니다. 항공권 발권은 금전이 오가는 행위이고, 누군가의 인가 아래에서 이루어지며, BSP나 그에 준하는 체계로 정산됩니다. 그 누군가가 여러분이 아니라면 그쪽과 계약이 필요합니다. 이 질문을 건너뛴 팀은 그럴듯한 검색 페이지와, 아무도 돈을 내지 않는 예약만 만들어 내는 예약 버튼을 갖게 됩니다.
천천히 읽어야 할 또 하나의 열은 콘텐츠입니다. GDS 콘텐츠와 NDC 콘텐츠는 같은 운임이 아니며, 저비용항공은 어느 쪽에도 없는 경우가 많습니다. 사용자 대부분이 저비용항공이 많은 지역에서 단거리 노선을 탄다면, GDS 커버리지가 뛰어난 경로라도 결과가 빈약할 수 있습니다. 이 차이는 NDC API와 GDS: 연동 개발자에게 달라진 점에서 다뤘습니다.
이 플랫폼의 접근 방식, 그리고 이것도 키가 아닌 이유
이 플랫폼은 항공권과 호텔 API를 제공합니다. 접근은 셀프서비스 키가 아니라 대화로 시작합니다. 이 점을 분명히 밝히는 이유는, 이번 주 여러분에게 가장 나쁜 결과가 예전 경험을 기대하고 어딘가에 가입했다가 나흘째에 사람의 승인 절차가 가로막고 있다는 걸 알게 되는 일이기 때문입니다.
그 대화는 대부분 표에 나온 질문에 관한 것입니다. 무엇을 만들고 있는지, 사용자는 누구인지, 발권이 필요한지 아니면 검색과 가격만 필요한지, 어느 시장에서 판매하는지. 이 답들이 어떤 콘텐츠를 받을지, 예약이 어떻게 정산될지를 결정합니다. 시작하고 싶다면 여행 API 페이지에서 출발하면 됩니다.
어디로 가든 첫 이메일에서 같은 것을 물어보세요. 셀프서비스 테스트 키가 있는지, 프로덕션 전에 무엇이 필요한지. 분명한 답은 나머지 연동에 대해서도 좋은 신호입니다. 모호한 답 역시 무언가를 알려 줍니다.
이전 체크리스트: 망가지는 순서대로
셀프서비스 연동 대부분은 같은 모양이었습니다. 검색, 가격 확인, 주문 생성, 발권, 그리고 항공권이 생긴 뒤 일어나는 일의 처리. 새 공급사를 상대로 각 단계를 한 번도 작성한 적 없는 것처럼 다시 테스트하세요. 요청 이름은 다르겠지만, 정말 문제를 일으키는 건 코드 속에 묻힌 가정입니다.
- 검색. 쿼리 모델(출발지, 도착지, 날짜, 승객, 좌석 등급)을 새 요청에 맞춰 연결합니다. 소아와 유아의 나이를 어떻게 넘기는지, 다구간이 별도 호출인지, 결과가 비었을 때 어떤 모습인지 확인하세요. 빈 목록과 오류는 다른 것인데, 여러분의 UI는 아마 둘을 똑같이 다루고 있을 것입니다.
- 오퍼 식별자. 오퍼 id가 얼마 동안 유효한지, 페이지를 새로 고쳐도 살아 있는지 알아 두세요. 오퍼를 세션에 저장했다가 10분 뒤 가격을 확인하는 코드는 새로운 방식으로 실패합니다.
- 가격 확인. 대부분의 공급사에서 예약 전 재가격 확인은 선택 사항이 아닙니다. 가격이 바뀐 경우를 처리하고, 그때 사용자가 무엇을 보게 될지 정해 두세요.
- 주문. 승객 이름, 여권 등 서류 항목, 연락처. 보내기 전에 여러분 쪽에서 형식을 검증하세요. 고객이 결제한 뒤 주문이 거절되는 것이 이 목록에서 가장 값비싼 버그입니다.
- 발권. 주문 호출이 발권까지 하는지, 아니면 발권이 자체 시한을 가진 별도 단계인지 확인하세요. 누구의 돈을 받기 전에, 항공권이 누구의 자격으로 발권되는지 알아야 합니다.
- 발권 이후. 취소, 보이드(void), 환불, 스케줄 변경. 프로토타입에서는 필요 없었지만 실제 제품은 첫 달에 바로 필요해지는 호출입니다. API에 있는지, 고객지원 창구를 거쳐야 하는지 물어보세요.
무엇을 흉내 내도 되고 무엇은 절대 흉내 내면 안 되는지를 포함한 더 자세한 테스트 계획은 여행 API 샌드박스 테스트 계획을 참고하세요. 연동 쪽에서 접근한다면 항공권 예약 API 연동이 전체 흐름을 설명합니다.
서두른 이전이 치르는 비용
가장 끌리는 방법은 새 공급사를 기존 클라이언트 인터페이스 뒤에 감싸 두고, 검색이 결과를 돌려주자마자 배포하는 것입니다. 검색은 멀쩡해 보일 겁니다. 실패하는 건 데모에서 보여 주지 않은 모든 것입니다.
검색과 주문 사이에 바뀐 가격이 날것의 오류로 사용자에게 보이면 그 예약은 사라집니다. 새 공급사가 주문과 발권을 두 단계로 나누는데 코드가 그렇지 않다면, 발권 없이 주문만 생기고 승객은 항공권이 있다고 믿지만 실제로는 없습니다. 누군가 고객지원에 연락하기 전까지 조용히 아무것도 하지 않는 환불 흐름은 차지백이 됩니다. 각각은 한 번이라면 버틸 수 있습니다. 하지만 사용자 전체에서 반복되면, 작은 여행 제품이 기대어 사는 신뢰를 잃게 됩니다.
더 조용한 비용도 있습니다. 이번 주에 가장 빨랐다는 이유로 경로를 골랐는데 그 경로에 사용자가 검색하는 콘텐츠가 없다면, 이전을 두 번 하게 됩니다. 코드를 쓰기 전에 콘텐츠와 발권 질문에 하루를 쓰는 것이 이 작업 전체에서 가장 싼 보험입니다.
대략 일주일
첫날은 질문에 씁니다. 어떤 경로, 어떤 콘텐츠, 누구의 발권 자격. 둘째 날과 셋째 날은 새 공급사를 상대로 검색과 가격 확인. 넷째 날은 주문과 발권을 처음부터 끝까지, 실패 사례까지 포함해서. 다섯째 날은 발권 이후 처리와 여러분 자신의 로그를 읽는 데 씁니다. 공급사와의 대화가 하루를 넘기면, 그쪽 문서를 보며 병행해서 코드를 쓰기 시작하세요. 요청 형식은 한 번 보고 나면 거의 바뀌지 않습니다.
첫 셀프서비스 키를 받던 그 오후처럼 느껴지지는 않을 것입니다. 그럴 필요도 없습니다. 지금 만드는 것은 누군가 책임지는 항공권을 발권해야 하니까요.