본문으로 건너뛰기
블로그

두바이에서 API 연동 업체를 고용하기 전에

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

책상 위에 견적서가 세 장 있습니다. 세 연동 업체 모두 여행 사이트 포트폴리오가 있고, 모두 "항공 API를 웹사이트에 연결해 드린다"고 약속하며, 가장 싼 곳은 다음 주에 바로 시작할 수 있다고 합니다. 당신은 데이라에서 직원 여섯 명과 꾸준한 기업 고객을 둔 여행사를 운영하고 있고, 공급사 엑스트라넷의 요금을 왓츠앱 메시지로 다시 옮겨 적는 일에 지쳤습니다. 가장 유능해 보이는 두바이 API 연동 업체를 고르는 것이 결정의 전부처럼 느껴집니다.

실제로는 3분의 1 정도입니다. 사이트가 팔리느냐를 정하는 결정은 세 견적서 어디에도 없습니다. 그것들은 코드가 아니기 때문입니다. 공급사와 누가 계약했는지, 항공권이 누구 이름으로 발권되는지, 예약과 발권 사이에 돈이 어디에 머무는지, 고객이 취소했을 때 환불은 누가 처리하는지. 연동 업체는 이 모든 것을 서로 이어 줄 수 있습니다. 하지만 당신 대신 그 어느 것도 될 수는 없습니다.

이 글은 작업 범위서를 읽을 개발자가 아니라, 거기에 서명할 대표를 위해 썼습니다.

두바이 API 연동 업체가 해 줄 수 있는 것과 없는 것

연동 업체는 공급사의 API와 당신의 웹사이트 사이의 코드를 씁니다. 검색 폼, 좌석과 객실을 묻는 호출, 결제 전 가격 재확인, 예약 요청, 결과를 보여 주는 화면, 그리고 범위에 들어 있다면 취소와 환불 호출까지. 좋은 업체는 지루하지만 중요한 부분도 챙깁니다. 공급사가 응답하지 않을 때의 재시도, 실패한 예약을 추적할 수 있는 로그, 운영 환경처럼 동작하는 테스트 환경 같은 것들입니다.

그들이 건네줄 수 없는 것은 그 코드 건너편에 있는 모든 것입니다. 코드 한 줄이 쓰이기 전에 여행사에는 다음이 필요합니다.

  • 여행사 자신의 이름으로 된 공급사 계정, 그리고 그 계정에 부여된 API 접근 권한;
  • 발권 권한: 자체 인가를 갖거나, 대신 발권해 주는 consolidator를 두거나;
  • 그 공급사와의 자금 방식: 예치금, 신용 한도, 또는 카드 결제 대행;
  • 발권 이후의 업무(void, 환불, 재발행, 스케줄 변경)를 API로, 안 되면 수작업으로라도 처리할 사람.

"공급사 쪽은 저희가 알아서 하겠다"는 연동 업체는 대개 자기 계정을 빌려주겠다는 뜻입니다. 시제품을 위한 지름길로는 합리적일 수 있습니다. 그러나 사업이라면, 당신의 예약 사이트가 당신이 갖고 있지도 않고 나중에 가지고 나갈 수도 없는 관계 위에서 돌아간다는 뜻입니다.

요구사항서: 작업 범위서에 넣을 일곱 줄

연동 업체와의 분쟁은 대부분 아무도 적어 두지 않은 한 문장으로 거슬러 올라갑니다. 서명할 문서에 이것들을 쉬운 말로 넣고, 각각의 답을 서면으로 받으십시오.

  1. 공급사 계정과 API 키는 누구 명의인가. 여행사 명의입니다. 키는 자격 증명입니다. 당신의 비밀번호 보관함에 두고, 연동 업체에는 소유권이 아니라 접근 권한을 줍니다.
  2. 사이트는 누가 호스팅하고 도메인은 누가 갖는가. 도메인은 여행사 명의로 등록합니다. 호스팅 계정도 여행사 것이거나, 어떻게 이전되는지 계약서에 정확히 적습니다.
  3. 어떤 기능이 범위에 들어가는가. 이름으로 나열하십시오: 검색, 가격 확인, 예약, 발권, 취소, 환불, 변경. 목록에 없는 것은 사이트가 살아 있는 내내 공급사 데스크에 보내는 이메일로 남습니다. 환불과 변경이 가장 자주 빠집니다. 데모에서는 절대 보여 주지 않는 기능이기 때문입니다.
  4. 공급사가 API를 바꾸면 누가 유지보수하는가. 공급사는 버전을 종료하고 필드 이름을 바꿉니다. 유지보수 조항 없는 고정가 개발은 첫 버전이 바뀌는 날 끝납니다.
  5. 인계란 무엇을 뜻하는가. 여행사가 소유한 저장소의 소스 코드, 모든 자격 증명, 그리고 다른 개발자가 이어받을 수 있게 해 주는 문서. "압축 파일로 보내 드리겠다"는 인계가 아닙니다.
  6. 오픈은 어떻게 증명하는가. 실제 고객의 카드를 받기 전에, 공급사 테스트 환경에서 검색부터 발권까지, 취소까지 포함한 테스트 예약 한 건.
  7. 고객 데이터는 어떻게 되는가. 승객 이름, 여권 정보, 결제 참조 번호. 어디에 저장되고, 누가 읽을 수 있으며, 어떻게 삭제되는지.

이 중 어느 것도 기술 배경이 있어야 쓸 수 있는 것이 아닙니다. 그리고 하나하나가 개발 후에 협상하는 것보다 개발 전에 합의하는 편이 쌉니다.

공급사 콘텐츠를 사이트에 올리는 세 가지 방법

공급사 API에 대해 연동 업체를 고용하는 것은 하나의 길입니다. 견적서가 선택을 대신해 버리기 전에, 다른 두 길과 나란히 놓고 볼 가치가 있습니다.

방법공급사 관계는 누가 갖는가연결이 계속 작동하게 하는 쪽여행사가 여전히 만들어야 하는 것떠날 때의 비용
연동 업체가 당신 사이트를 공급사 API에 연결요구사항서에 적었다면 여행사, 아니면 흔히 연동 업체유지보수 계약을 맺은 연동 업체, 또는 아무도 아님관리자 화면, 마크업, 고객 기록, 리포트, 결제, 사후 처리 화면코드와 키가 당신 것이면 적음, 아니면 재개발
연동 업체가 당신 사이트를 플랫폼 API에 연결공급사 계약은 플랫폼이, 플랫폼 계정은 여행사가공급사 쪽은 플랫폼, 당신 쪽은 연동 업체당신의 사이트, 그리고 플랫폼 API가 다루지 않는 부분다른 API에 맞춰 당신 쪽을 다시 작성
이미 연결된 화이트 라벨 스토어프런트여행사 계정을 통해 플랫폼이플랫폼콘텐츠, 가격 결정, 당신의 고객도메인과 고객 목록을 다른 업체로 옮기기

따져 볼 만한 줄은 첫 번째입니다. 통제권이 가장 크고, 짐도 가장 많이 당신에게 지웁니다. 공급사의 모든 변경, 새로운 서비스, 첫 개발에서 빠진 모든 기능이 또 다른 견적의 또 다른 프로젝트가 됩니다.

이미 운영 중인 사이트에 검색을 넣는 방법은 기존 웹사이트에 항공권 검색 추가하기에서, 그 뒤에 누구의 API를 둘지는 항공권 예약 API 공급사 선택에서 다뤘습니다. 이 글은 그 작업을 둘러싼 계약에 관한 것입니다.

이 플랫폼의 위치

이 블로그를 운영하는 플랫폼은 항공과 호텔 API를 제공합니다. 접근은 셀프 서비스 키가 아니라 대화로 시작합니다. 첫 질문이 어떤 엔드포인트를 부를지가 아니라 위에 적은 것들, 즉 어떤 서비스를, 어느 시장에서, 돈이 어떻게 움직이는지이기 때문입니다. 서비스는 계정별로 활성화되고, 모든 계정에는 자기 예약, 고객, 마크업, 리포트를 가진 자체 관리자 패널이 있습니다. 그래서 표 두 번째 줄의 "여전히 만들어야 하는 것" 칸은 보이는 것보다 짧습니다.

연동 업체가 당신 쪽을 만들 예정이라면, 견적을 받아들이기 전에 그 대화를 먼저 하십시오. 그래야 작업 범위가 실제로 연결할 API를 기준으로 쓰입니다. 시작점은 여행 API 페이지입니다.

허술한 요구사항서의 대가

사이트가 오픈합니다. 검색이 되고 가격도 맞아 보이며, 첫 예약이 목요일 저녁에 들어옵니다. 그런데 당신 이름으로는 발권할 수 없습니다. 공급사 계정이 연동 업체 것이고 그들의 계약으로 발권되기 때문입니다. 고객의 카드는 이미 결제되었습니다. 당신은 이제 자기 사이트로는 발권도 환불도 할 수 없는 예약을 손에 쥐고 있습니다.

아니면 1년 동안은 잘 돌아갑니다. 그러다 공급사가 새 API 버전으로 옮기고, 예약이 멈추고, 인계와 함께 고정가 계약이 끝난 연동 업체가 새 프로젝트 견적을 냅니다. 당신은 냅니다. 그 코드를 이해하는 사람이 견적을 낸 바로 그 사람들뿐이니까요.

아니면 연동 업체가 그저 다른 일로 바쁩니다. 고객이 항공권의 이름 철자를 고쳐야 하는데, 변경 기능은 처음부터 범위에 없었고, 직원 두 명이 오후 내내 공급사 데스크에 이메일을 보냅니다. 사이트가 없애 주기로 했던 바로 그 일입니다.

매번 요구사항서에서 빠진 한 문장 때문입니다. 코드는 매번 멀쩡했습니다.

Tekravel 편집팀

여행 기술 데스크

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