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

책상 위에 견적서가 세 장 있습니다. 세 연동 업체 모두 여행 사이트 포트폴리오가 있고, 모두 "항공 API를 웹사이트에 연결해 드린다"고 약속하며, 가장 싼 곳은 다음 주에 바로 시작할 수 있다고 합니다. 당신은 데이라에서 직원 여섯 명과 꾸준한 기업 고객을 둔 여행사를 운영하고 있고, 공급사 엑스트라넷의 요금을 왓츠앱 메시지로 다시 옮겨 적는 일에 지쳤습니다. 가장 유능해 보이는 두바이 API 연동 업체를 고르는 것이 결정의 전부처럼 느껴집니다.
실제로는 3분의 1 정도입니다. 사이트가 팔리느냐를 정하는 결정은 세 견적서 어디에도 없습니다. 그것들은 코드가 아니기 때문입니다. 공급사와 누가 계약했는지, 항공권이 누구 이름으로 발권되는지, 예약과 발권 사이에 돈이 어디에 머무는지, 고객이 취소했을 때 환불은 누가 처리하는지. 연동 업체는 이 모든 것을 서로 이어 줄 수 있습니다. 하지만 당신 대신 그 어느 것도 될 수는 없습니다.
이 글은 작업 범위서를 읽을 개발자가 아니라, 거기에 서명할 대표를 위해 썼습니다.
두바이 API 연동 업체가 해 줄 수 있는 것과 없는 것
연동 업체는 공급사의 API와 당신의 웹사이트 사이의 코드를 씁니다. 검색 폼, 좌석과 객실을 묻는 호출, 결제 전 가격 재확인, 예약 요청, 결과를 보여 주는 화면, 그리고 범위에 들어 있다면 취소와 환불 호출까지. 좋은 업체는 지루하지만 중요한 부분도 챙깁니다. 공급사가 응답하지 않을 때의 재시도, 실패한 예약을 추적할 수 있는 로그, 운영 환경처럼 동작하는 테스트 환경 같은 것들입니다.
그들이 건네줄 수 없는 것은 그 코드 건너편에 있는 모든 것입니다. 코드 한 줄이 쓰이기 전에 여행사에는 다음이 필요합니다.
- 여행사 자신의 이름으로 된 공급사 계정, 그리고 그 계정에 부여된 API 접근 권한;
- 발권 권한: 자체 인가를 갖거나, 대신 발권해 주는 consolidator를 두거나;
- 그 공급사와의 자금 방식: 예치금, 신용 한도, 또는 카드 결제 대행;
- 발권 이후의 업무(void, 환불, 재발행, 스케줄 변경)를 API로, 안 되면 수작업으로라도 처리할 사람.
"공급사 쪽은 저희가 알아서 하겠다"는 연동 업체는 대개 자기 계정을 빌려주겠다는 뜻입니다. 시제품을 위한 지름길로는 합리적일 수 있습니다. 그러나 사업이라면, 당신의 예약 사이트가 당신이 갖고 있지도 않고 나중에 가지고 나갈 수도 없는 관계 위에서 돌아간다는 뜻입니다.
요구사항서: 작업 범위서에 넣을 일곱 줄
연동 업체와의 분쟁은 대부분 아무도 적어 두지 않은 한 문장으로 거슬러 올라갑니다. 서명할 문서에 이것들을 쉬운 말로 넣고, 각각의 답을 서면으로 받으십시오.
- 공급사 계정과 API 키는 누구 명의인가. 여행사 명의입니다. 키는 자격 증명입니다. 당신의 비밀번호 보관함에 두고, 연동 업체에는 소유권이 아니라 접근 권한을 줍니다.
- 사이트는 누가 호스팅하고 도메인은 누가 갖는가. 도메인은 여행사 명의로 등록합니다. 호스팅 계정도 여행사 것이거나, 어떻게 이전되는지 계약서에 정확히 적습니다.
- 어떤 기능이 범위에 들어가는가. 이름으로 나열하십시오: 검색, 가격 확인, 예약, 발권, 취소, 환불, 변경. 목록에 없는 것은 사이트가 살아 있는 내내 공급사 데스크에 보내는 이메일로 남습니다. 환불과 변경이 가장 자주 빠집니다. 데모에서는 절대 보여 주지 않는 기능이기 때문입니다.
- 공급사가 API를 바꾸면 누가 유지보수하는가. 공급사는 버전을 종료하고 필드 이름을 바꿉니다. 유지보수 조항 없는 고정가 개발은 첫 버전이 바뀌는 날 끝납니다.
- 인계란 무엇을 뜻하는가. 여행사가 소유한 저장소의 소스 코드, 모든 자격 증명, 그리고 다른 개발자가 이어받을 수 있게 해 주는 문서. "압축 파일로 보내 드리겠다"는 인계가 아닙니다.
- 오픈은 어떻게 증명하는가. 실제 고객의 카드를 받기 전에, 공급사 테스트 환경에서 검색부터 발권까지, 취소까지 포함한 테스트 예약 한 건.
- 고객 데이터는 어떻게 되는가. 승객 이름, 여권 정보, 결제 참조 번호. 어디에 저장되고, 누가 읽을 수 있으며, 어떻게 삭제되는지.
이 중 어느 것도 기술 배경이 있어야 쓸 수 있는 것이 아닙니다. 그리고 하나하나가 개발 후에 협상하는 것보다 개발 전에 합의하는 편이 쌉니다.
공급사 콘텐츠를 사이트에 올리는 세 가지 방법
공급사 API에 대해 연동 업체를 고용하는 것은 하나의 길입니다. 견적서가 선택을 대신해 버리기 전에, 다른 두 길과 나란히 놓고 볼 가치가 있습니다.
| 방법 | 공급사 관계는 누가 갖는가 | 연결이 계속 작동하게 하는 쪽 | 여행사가 여전히 만들어야 하는 것 | 떠날 때의 비용 |
|---|---|---|---|---|
| 연동 업체가 당신 사이트를 공급사 API에 연결 | 요구사항서에 적었다면 여행사, 아니면 흔히 연동 업체 | 유지보수 계약을 맺은 연동 업체, 또는 아무도 아님 | 관리자 화면, 마크업, 고객 기록, 리포트, 결제, 사후 처리 화면 | 코드와 키가 당신 것이면 적음, 아니면 재개발 |
| 연동 업체가 당신 사이트를 플랫폼 API에 연결 | 공급사 계약은 플랫폼이, 플랫폼 계정은 여행사가 | 공급사 쪽은 플랫폼, 당신 쪽은 연동 업체 | 당신의 사이트, 그리고 플랫폼 API가 다루지 않는 부분 | 다른 API에 맞춰 당신 쪽을 다시 작성 |
| 이미 연결된 화이트 라벨 스토어프런트 | 여행사 계정을 통해 플랫폼이 | 플랫폼 | 콘텐츠, 가격 결정, 당신의 고객 | 도메인과 고객 목록을 다른 업체로 옮기기 |
따져 볼 만한 줄은 첫 번째입니다. 통제권이 가장 크고, 짐도 가장 많이 당신에게 지웁니다. 공급사의 모든 변경, 새로운 서비스, 첫 개발에서 빠진 모든 기능이 또 다른 견적의 또 다른 프로젝트가 됩니다.
이미 운영 중인 사이트에 검색을 넣는 방법은 기존 웹사이트에 항공권 검색 추가하기에서, 그 뒤에 누구의 API를 둘지는 항공권 예약 API 공급사 선택에서 다뤘습니다. 이 글은 그 작업을 둘러싼 계약에 관한 것입니다.
이 플랫폼의 위치
이 블로그를 운영하는 플랫폼은 항공과 호텔 API를 제공합니다. 접근은 셀프 서비스 키가 아니라 대화로 시작합니다. 첫 질문이 어떤 엔드포인트를 부를지가 아니라 위에 적은 것들, 즉 어떤 서비스를, 어느 시장에서, 돈이 어떻게 움직이는지이기 때문입니다. 서비스는 계정별로 활성화되고, 모든 계정에는 자기 예약, 고객, 마크업, 리포트를 가진 자체 관리자 패널이 있습니다. 그래서 표 두 번째 줄의 "여전히 만들어야 하는 것" 칸은 보이는 것보다 짧습니다.
연동 업체가 당신 쪽을 만들 예정이라면, 견적을 받아들이기 전에 그 대화를 먼저 하십시오. 그래야 작업 범위가 실제로 연결할 API를 기준으로 쓰입니다. 시작점은 여행 API 페이지입니다.
허술한 요구사항서의 대가
사이트가 오픈합니다. 검색이 되고 가격도 맞아 보이며, 첫 예약이 목요일 저녁에 들어옵니다. 그런데 당신 이름으로는 발권할 수 없습니다. 공급사 계정이 연동 업체 것이고 그들의 계약으로 발권되기 때문입니다. 고객의 카드는 이미 결제되었습니다. 당신은 이제 자기 사이트로는 발권도 환불도 할 수 없는 예약을 손에 쥐고 있습니다.
아니면 1년 동안은 잘 돌아갑니다. 그러다 공급사가 새 API 버전으로 옮기고, 예약이 멈추고, 인계와 함께 고정가 계약이 끝난 연동 업체가 새 프로젝트 견적을 냅니다. 당신은 냅니다. 그 코드를 이해하는 사람이 견적을 낸 바로 그 사람들뿐이니까요.
아니면 연동 업체가 그저 다른 일로 바쁩니다. 고객이 항공권의 이름 철자를 고쳐야 하는데, 변경 기능은 처음부터 범위에 없었고, 직원 두 명이 오후 내내 공급사 데스크에 이메일을 보냅니다. 사이트가 없애 주기로 했던 바로 그 일입니다.
매번 요구사항서에서 빠진 한 문장 때문입니다. 코드는 매번 멀쩡했습니다.