여행 API 비교: 공급사가 아니라 평가 축으로 판단하라

세 공급사의 소개 자료를 탭 세 개에 띄워 놓았습니다. 어느 자료에나 긴 항공사 목록 슬라이드, 호텔 수 슬라이드, sandbox, REST와 JSON, 지원 이메일이 있습니다. 스프레드시트를 만들고 칸마다 체크를 하면, 결과는 무승부입니다. 기능 체크리스트로 진행한 여행 API 비교는 대개 이렇게 끝나고, 이것은 잘못된 결말입니다. 내년을 좌우할 차이는 go-live 이후에야 드러나기 때문입니다. 공급사 쪽에서는 성공했지만 우리 쪽에서는 timeout이 난 예약, 아무도 처리하지 못하는 환불, 목록에는 있었지만 이 경로로는 발권이 안 되는 항공사 같은 것들입니다.
이 글은 그 결정을 내리고 나중에 그 결정을 설명해야 하는 개발자나 기술 리드를 위한 글입니다. 공급사 순위를 매기지 않습니다. 대신 비교에 쓸 평가 축, 시간의 대부분을 실패 상황에 쓰는 트라이얼 계획, 그리고 지금 상대가 실제 공급사인지 남의 공급사를 되파는 곳인지 빨리 알려 주는 몇 가지 질문을 드립니다.
기능 체크리스트가 늘 무승부로 끝나는 이유
체크리스트는 어떤 기능이 있느냐고 묻습니다. 거의 모든 여행 API가 거의 모든 행에 "있다"고 답할 수 있습니다. 행 자체가 마케팅 페이지 수준으로 쓰여 있기 때문입니다. 검색, 요금, 예약, 취소, 발권, webhook, sandbox. 이들을 실제로 갈라놓는 질문은 cancel이 있느냐가 아니라, 출발 열두 시간 전에 이미 발권된 예약에, 위약금이 걸린 운임에, 제3자에게서 온 콘텐츠 경로로 그것을 호출하면 무슨 일이 일어나느냐입니다. 체크리스트에는 그런 칸이 없습니다.
두 번째 문제도 있습니다. 체크리스트를 채우는 쪽은 대개 공급사 자신입니다. 결국 그들의 자기소개에 점수를 매기는 셈입니다.
공급사가 아니라 평가 축으로 하는 여행 API 비교
"공급사 × 기능" 표를 버리고, 트라이얼에서 직접 모은 증거로 스스로 점수를 매기는 평가 축으로 바꾸십시오. 아래 표가 저희라면 쓸 표입니다. 행마다 가중치는 달라도 됩니다. 호텔만 파는 회사라면 발권에는 덜 신경 쓸 테니까요. 채택하기 전에 이 표와 한번 논쟁해 보시기 바랍니다.
| 평가 축 | 체크리스트가 묻는 것 | 실제로 확인할 것 | 약한 답변은 이렇게 들린다 |
|---|---|---|---|
| 커버리지 | 항공사와 호텔이 몇 개인가? | 그중 몇 개를 이 API로 검색·예약하고, 발권 또는 확정까지 할 수 있는가 — 우리 시장 기준으로 | 내역 없는 큰 숫자 하나 |
| 깊이 | 취소 endpoint가 있는가? | 예약 후 작업 중 무엇이 콘텐츠 소스별로 자동화되어 있는가: void, 환불, reissue, 이름 정정, 부가 서비스 | "그건 저희 운영팀이 처리합니다" |
| 요금 신뢰성 | 요금이 실시간인가? | 예약 시점 요금이 검색 시점 요금과 얼마나 자주 다르고, API가 그것을 어떻게 알려 주는가 | "요금은 항상 실시간입니다" |
| 오류의 의미 | 오류가 문서화되어 있는가? | 오류가 "뭔가 실패했다"를 넘어 예약이 지금 어떤 상태인지 알려 주는가 | 모든 실패에 같은 범용 오류 코드 |
| 멱등성 | — | 예약 호출을 재시도하면 두 번째 예약이 생길 수 있는가 | 침묵, 그다음 "그런 경우는 본 적이 없습니다" |
| Supplier of record | — | 누구의 계약, 누구의 IATA 번호, 누구의 BSP로 발권되는가 | "주요 GDS와는 모두 일합니다" |
| 접근성과 지원 | sandbox가 있는가? | 실제 PNR이 멈췄을 때 누가, 얼마나 빨리 답하는가 | 티켓 양식뿐, 담당자 이름 없음 |
이 중 두 행에는 체크리스트 질문이 아예 없습니다. 우연이 아닙니다. 문제가 생겼을 때 가장 비싼 행이고, 공급사 자료가 먼저 꺼낼 가능성이 가장 낮은 행이기 때문입니다.
커버리지는 깊이가 아니다
항공사 목록은 어느 소개 자료에서나 가장 오해를 부르는 슬라이드입니다. 수백 개 항공사 목록은 여러 가지를 의미할 수 있고, 그중 원하는 것은 하나뿐입니다.
일부 항공사는 GDS를 통해 들어오며 예약부터 발권까지 끝까지 처리됩니다. 일부는 NDC 연결로 들어오는데, 검색은 잘 되더라도 예약 이후의 서비스 — 변경, 부분 환불, 수하물 추가 — 는 그 항공사에 대해 여전히 수작업일 수 있습니다. 일부는 다른 리셀러에게서 콘텐츠를 모아 온 저비용 항공사입니다. 화면에 띄울 수는 있고, 때로는 예약도 되지만, 항공권은 통제할 수 없는 경로로, 고객에게 약속할 수 없는 시점에 도착합니다. 그리고 일부는 검색 응답에 운임이 한 번 나온 적이 있다는 이유만으로 목록에 올라 있습니다.
보여 줄 수는 있지만 발권할 수 없는 항공사는 커버리지가 아닙니다. 리테일 상품이라면 아예 없는 것보다 더 나쁩니다. 고객이 고르고, 결제하고, 그다음 기다리기 때문입니다.
호텔도 단어만 다를 뿐 모양은 같습니다. 숙소 수에는 공급사가 매핑한 곳과 매핑하지 않은 곳이 섞여 있고, 지난주에 캐시된 정적 요금이 실시간 객실 현황 옆에 있으며, release period가 있는 allotment 객실이 free-sale 재고 옆에 있습니다. 우리가 판매하는 도시에서 실시간으로 예약 가능한 숫자를 요청하고, 자기 공급사들 사이의 중복을 어떻게 병합하는지 물어보십시오. 같은 호텔이 세 가지 가격으로 세 번 나오는 것은 언제 터질지 모르는 고객 문의입니다.
실전 테스트는 좁게 잡습니다. 물량의 대부분을 차지하는 노선 스무 개와 호텔 도시 스무 곳을 적어서, 바로 그것들이 sandbox에서 처음부터 끝까지 동작하는지 보여 달라고 하십시오. 검색, 요금, 예약, 발권 또는 확정, 취소까지. 깊이가 있는 공급사는 군말 없이 해 보입니다. 슬라이드만 있는 공급사는 슬라이드 이야기를 시작합니다.
트라이얼에서 시험할 것: 정상 경로가 아니라 오류 경로
어느 sandbox든 한산한 노선의 편도 일반석 예약은 성공합니다. sandbox는 바로 그것을 보여 주려고 만든 것입니다. 실제 운영 트래픽은 생애의 상당 부분을 나머지 경로에서 보내게 되고, 그것을 싸게 볼 수 있는 때는 트라이얼뿐입니다.
트라이얼 동안 아래 목록을 돌리고, API가 무엇을 반환했는지와 그 뒤 실제로 무엇이 사실이었는지를 나란히 기록하십시오.
- 검색과 예약 사이의 요금 변동. 예약 호출이 실패합니까, 새 요금으로 성공합니까, 아니면 확인을 요구하는 별도 응답을 돌려줍니까? UI가 메시지 문자열을 파싱하지 않고도 구분할 수 있습니까?
- 만료된 오퍼. 검색 후 공급사의 오퍼 유효 시간보다 오래 기다렸다가 예약합니다. 만료가 별도 오류입니까, "공급사 장애"와 같은 오류입니까?
- 예약 시점 매진. 요금 확인과 예약 사이에 재고가 사라진 경우. 예약은 어떤 상태이며, 결제 승인은 해제됩니까?
- timeout 후 재시도. 예약 요청을 보내고 응답 전에 연결을 끊은 뒤 다시 보냅니다. 이제 PNR이 하나입니까, 둘입니까? 이 테스트 하나가 나머지 트라이얼 전체보다 공급사에 대해 더 많은 것을 알려 줍니다.
- 예약은 생성, 발권은 실패. API가 존재하지만 발권되지 않은 PNR을 보고할 수 있고, 발권 기한을 알려 줍니까?
- 부분 실패. 객실 여러 개를 요청했는데 하나는 확정되고 하나는 안 된 호텔 예약. 가는 편과 오는 편이 서로 다른 소스에서 온 왕복 항공권.
- 무료 취소 기간 밖의 취소. 위약금이 확정 전에 안내됩니까, 아니면 청구서에서 발견됩니까?
- 공급사 장애. 어떻게 재현하는지 공급사에 물어보십시오. 못 한다면, 기존 고객들은 그 동작을 어떻게 알게 되었는지 물어보십시오.
각 사례마다 두 가지를 채점합니다. 첫째, API가 예약 상태에 대해 사실을 말하는가. 둘째, 사람이 자유 텍스트를 읽지 않아도 코드가 그 사실에 따라 움직일 수 있는가. 명확하게 실패하는 API가 애매하게 성공하는 API보다 함께 지내기 훨씬 쉽습니다.
항공 쪽은 항공권 예약 API 문서가 말하지 않는 것에서, 느린 호텔 공급사를 위한 클라이언트 설계는 호텔 객실 가용성 글에서 더 자세히 다뤘습니다. 둘 다 트라이얼 계획과 함께 읽기 좋습니다.
얇은 애그리게이터를 가려내는 질문
애그리게이터 자체는 잘못이 없습니다. 대부분의 여행 콘텐츠는 애그리게이터를 거쳐 대부분의 판매자에게 닿습니다. 위험한 것은 얇은 쪽입니다. 다른 계층의 API를 되팔면서 마진만 얹고, 공급 계약도 운영 데스크도 갖지 않은 계층입니다. 문제가 생기면 답이 회사 두 곳을 거슬러 올라갔다가 돌아와야 합니다.
다섯 가지 질문이면 금방 드러납니다.
- 이 예약의 supplier of record는 누구입니까? 항공사나 호텔과 맺은 누구의 계약 위에 서 있습니까?
- 항공권은 누구의 IATA 번호와 BSP로 나갑니까? "파트너 것"이라는 답이 나오면, 운임 규정을 어겼을 때 ADM은 누가 받는지 물어보십시오.
- 제가 cancel을 호출하면 그쪽에서는 무슨 일이 일어납니까? 공급사로 가는 자동 호출입니까, 사람이 집어 드는 대기열입니까?
- 상위 단계의 오류를 볼 수 있습니까? 얇은 계층은 받은 오류를 제대로 이해하지 못하기 때문에 모든 실패를 코드 하나로 뭉개는 경향이 있습니다.
- 실제 예약이 멈추면 저는 누구에게 연락하고, 그 사람은 또 누구에게 연락합니까? 몇 단계인지 세어 보십시오.
이 답 중 어느 하나만으로 탈락시킬 이유는 없습니다. 파트너의 IATA 번호도 debit memo를 누가 부담하는지 계약에 분명히 적혀 있다면 괜찮을 수 있습니다. 중요한 것은 공급사가 정확하고 빠르게 답하느냐입니다. 여기서 받는 모호한 답은 나중에 운영 환경에서, 더 나쁜 시간대에 다시 받게 될 답입니다.
잘못 고르면 치르는 비용
연동은 싼 부분입니다. 비싼 부분은 나중에 오고, 어떤 견적에도 나오지 않습니다.
중복 예약 버그는 두 번 결제된 고객과, 직접 찾아서 수작업으로 취소해야 하는 PNR을 뜻합니다. 무료 void 기간이 이미 끝난 뒤일 수도 있습니다. 상위에서는 성공했는데 우리 쪽에는 실패로 기록된 예약은 좌석이 잡혔다가 자동 취소되고, 고객은 예약이 된 줄 알고 있는 상황을 뜻합니다. 보여 줬지만 발권하지 못한 항공사는 환불, 사과, 그리고 다시 오지 않는 고객을 뜻합니다. 공급사 경로가 운임 규정을 어겨 생긴 ADM은 항공권을 소유한 쪽에 떨어집니다. 그게 우리인지 미리 알아 두십시오.
여기에 전환 비용이 더해집니다. 받아들인 공급사의 특이점 하나하나 — 두 가지 뜻을 가진 상태 코드, 때로는 문자열인 필드 — 가 결국 데이터 모델에 들어갑니다. 2년쯤 지나면 API 선택은 스프린트 하나로 바꿀 수 있는 연동이 아니라 예약 테이블의 모양 그 자체가 됩니다. 지금 신중하게 비교해야 하는 진짜 이유입니다.
저희 API는 이 프레임워크에서 어디에 서 있는가
저희는 항공과 호텔 API를 제공합니다. 접근은 셀프서비스 키가 아니라 대화로 시작하며, 일부 개발자는 이를 느리다고 느낍니다. 그 대화가 바로 위의 질문들이 양방향으로 오가는 자리이기 때문입니다. 어떤 노선과 도시가 필요한지, 어떤 콘텐츠를 실제로 발권하거나 확정할 수 있는지, 예약 이후 누가 무엇을 맡는지. 비교를 진행 중이라면 이 목록을 가져오십시오. 대화는 여행 API 페이지에서 시작됩니다.
무엇을 고르든 소개 자료가 아니라 트라이얼 기록을 근거로 고르십시오. 소개 자료는 공급사가 되고 싶은 모습을 말해 줍니다. 오류 경로는 공급사의 실제 모습을 말해 줍니다.