최고의 항공권 예약 API: 먼저 무엇을 만드는지 정하세요

과제는 간단해 보입니다. 최고의 항공권 예약 API를 찾을 것. 그래서 비교 페이지 세 개를 엽니다. 세 페이지 모두 같은 몇몇 이름을 서로 다른 순서로 나열하고, 체크 표시로 가득한 기능표를 붙여 둡니다. 세 번째 페이지쯤 오면 어느 페이지도 묻지 않은 질문이 눈에 들어옵니다. 검색 결과가 나온 뒤, 고객에게는 무슨 일이 일어나는가.
빠진 그 질문이 곧 답입니다. 방문자를 항공사 사이트로 보내는 페이지에 맞는 최고의 항공권 예약 API는, 예약과 카드 결제를 직접 받는 사이트에는 나쁜 선택입니다. 여행사 직원이 하루 종일 쓰는 내부 도구에는 둘 다 맞지 않습니다. 검색, 가격 확인, 예약은 어느 레퍼런스 문서에서나 비슷해 보입니다. 차이는 그 아래에 있고, 그 차이 중 무엇이 당신에게 아픈지는 전적으로 제품에 달려 있습니다.
모두 "항공권 예약 사이트"라고 불리는 세 가지 제품
첫 번째는 비교 또는 영감을 주는 페이지입니다. 운임을 보여 주고, 외부로 링크하고, 항공권에는 절대 손대지 않습니다. 여기서 API는 거의 검색뿐입니다. 결과가 얼마나 넓고 최신인지, 그리고 화면의 가격이 방문자가 도착했을 때 보게 될 가격과 충분히 가까운지가 중요합니다. 당신의 시스템은 무엇도 무효화하거나 환불하거나 재발행할 일이 없으니, 그 부분에서 공급사가 가진 강점은 당신에게 쓸모가 없습니다.
두 번째는 판매합니다. 방문자가 당신에게 돈을 내고, 당신이 예약하며, 그 순간부터 예약의 수명 주기 전체를 떠안습니다. 결제 전에 가격을 확정하고, 응답이 느린 항공사를 처리하고, 당일 무효화하고, 나중에 환불하고, 고객이 날짜를 바꾸면 재발행합니다. 이 제품에서 검색 엔드포인트는 쉬운 부분입니다. 선택을 결정하는 속성은 그 뒤에 있습니다.
세 번째는 여행사 자체 도구로, 이미 공급사와 관계를 가진 직원들이 씁니다. 원시 검색은 핵심이 아닙니다. 중요한 것은 여행사가 직접 협상한 콘텐츠가 나타나는지, 하위 대리점에 신용 한도를 걸 수 있는지, 누구에게 가격이 보이기 전에 마크업이 적용되는지, 그리고 월말에 보고서가 있는지입니다. 두 번째 제품에 탁월한 API라도 여기서는 잘못된 기반일 수 있습니다.
분명히 말해 둘 가치가 있습니다. 같은 API가 세 가지 모두에서 최고일 수는 없습니다. 어떤 순위가 그렇다고 주장한다면, 그 순위는 두 번째 제품을 만나 본 적이 없는 것입니다.
비교할 가치가 있는 속성, 그리고 누가 거기에 기대는가
기능표를 개발자가 실제로 이견을 가질 수 있는 행만 남기고 줄여 보세요. 제품마다 기대는 부분이 다르고, 나머지는 마음 편히 무시해도 됩니다.
| 속성 | 리디렉션 페이지 | 판매 및 결제 | 여행사 직원용 도구 |
|---|---|---|---|
| 화면 가격이 확정 전까지 얼마나 오래돼도 되는가 | 조금 중요 | 결정적: 그 가격으로 결제함 | 중요: 직원이 그 가격으로 견적함 |
| 항공사가 느릴 때 예약 요청이 무엇을 반환하는가 | 해당 없음 | 결정적 | 중요 |
| 누가 무효화와 환불을 할 수 있고, 어떻게 요청하는가 | 해당 없음 | 결정적 | 결정적 |
| 결과를 알 수 없는 예약은 어떻게 해결되는가 | 해당 없음 | 결정적: 카드가 이미 결제됐을 수 있음 | 중요 |
| 여행사 자체 콘텐츠와 신용 규칙이 적용되는가 | 해당 없음 | 경우에 따라 | 결정적 |
| 테스트 동작이 실운영과 얼마나 다른가 | 낮음 | 높음 | 높음 |
당신의 열만 읽고 나머지는 무시하세요. 돈이 드는 실수는 평가하기 가장 쉽다는 이유로 리디렉션 열을 읽고, 두 번째 제품을 만드는 것입니다.
보여 주는 가격은 아직 청구할 가격이 아니다
두 번째 제품을 골라 운임 하나를 끝까지 따라가 봅시다. 검색이 가격을 돌려줍니다. 방문자는 그것을 보고, 고민하고, 다른 탭을 열었다가 돌아옵니다. 한참 뒤에 버튼을 누릅니다. 검색과 버튼 사이에 그 운임은 당신의 시스템 안에 머물러 있었고, 어떤 API에 대해서든 정직한 질문은 하나뿐입니다. 바로 그 순간 다시 물으면 API가 무엇이라고 답하는가.
공급사가 줄 수 있는 답은 세 가지입니다. 보여 준 가격을 확정할 수 있습니다. 새 가격을 돌려줄 수 있고, 그러면 당신의 코드는 차액을 청구할지, 고객에게 물을지, 멈출지 결정해야 합니다. 아니면 그 운임이 사라졌다고 말할 수 있습니다. 첫 번째 답만 대비한 사이트는 모든 데모에서 잘 돌아가다가 그 뒤 몇 주 동안 실패합니다. 그것도 오류를 던지는 방식이 아니라 돈을 잃는 방식으로요.
그러니 설계 질문은 API에 가격 확인 단계가 있느냐가 아닙니다. 거의 다 있습니다. 질문은 세 가지 결과 각각에 대해 응답이 어떤 모양인지, 그리고 당신의 코드가 추측 없이 그것들을 구분할 수 있는지입니다. 각각의 예시를 요청하세요. 문서에서 두 번째와 세 번째를 보여 줄 수 있는 공급사는 당신의 제품을 생각해 본 곳입니다. 첫 번째만 보여 주는 곳은 데모를 생각한 곳입니다.
어떤 표도 줄 수 없는 한나절의 테스트
후보 목록이 무엇이든, 각 이름에 같은 짧은 테스트를 돌리되 일부러 실패를 섞어 돌리세요. 무언가를 예약하고, 발권된 뒤 예약 객체가 무엇을 보존하는지 보세요. 같은 여정의 가격을 몇 분 간격으로 두 번 확인하고, 두 번째 답이 첫 번째와 어떤 관계인지 보세요. 취소한 다음 환불을 요청하고, 누가 움직여야 하는지 적어 두세요. 그리고 공급사에 서면으로 두 가지를 물으세요. 예약 도중 항공사가 타임아웃되면 시스템이 무엇을 반환하는가, 그리고 실제로 무슨 일이 일어났는지 어떻게 알 수 있는가.
서면 답변은 데모보다 값집니다. 결과를 알 수 없는 상황에 대한 명확한 절차가 있는 공급사는 그 문제를 이미 겪어 본 곳입니다. 기능 이름으로 답하는 공급사는 아닙니다.
테스트 계획 자체를 짜는 법은 샌드박스 테스트 계획에서 샌드박스가 보여 주지 않는 것들을 짚어 봅니다. 그리고 API 자체가 아니라 그 뒤에 무엇이 있는지로 공급사를 따지고 있다면, 그것은 별도의 질문이고 별도의 글이 있습니다. 이 글은 제품에 머뭅니다.
엔드포인트 목록으로 고르면 치르는 대가
실패는 조용합니다. 사이트가 가격을 늦게 확정하면, 화면 운임과 실제 운임의 차이가 예약 한 건씩 당신의 마진에서 빠져나갑니다. 고객 카드가 이미 결제된 상태로 예약이 결과 불명으로 남으면, 누군가 손으로 정리해야 합니다. 대개는 이메일로, 대개는 주말에. 검색 전용 콘텐츠 위에 만든 도구는 직원이 발권할 수 없는 물건으로 드러나고, 프로젝트는 다른 콘텐츠를 중심으로 다시 지어집니다.
이 중 어느 것도 체크 표시 표에는 보이지 않습니다. 모두 코드 한 줄을 쓰기 전에, 위 표의 첫 번째 열에서 이미 보였습니다.
우리 자신의 입장은 순위표가 허락하는 것보다 좁습니다. Tekravel은 항공과 호텔 API를 제공하고, 접근은 셀프서비스 키가 아니라 대화로 시작하며, 서비스는 테넌트별로 켜지고, 공급사 콘텐츠는 공급사 그룹을 통해 테넌트에 닿습니다. 이는 두 번째와 세 번째 제품에 맞습니다. 첫 번째를 만들고 있다면 우리가 전혀 필요 없을 수도 있습니다. 다른 둘 중 하나를 만들고 있다면 API 페이지에서 대화를 시작하세요.