호텔 API 공급사는 몇 곳이 필요할까? 매핑을 세어 보라

호텔 검색은 지난 분기에 공급사 한 곳으로 오픈했고, 한동안 아무도 불평하지 않았다. 그러다 영업팀이 스크린샷 하나를 전달한다. 이스탄불 여행을 준비하던 고객이 휴대폰으로 4성급 호텔을 찾았는데, 왜 우리 사이트에는 아예 나오지 않느냐고 물었다는 것이다. 가격이 더 비싼 게 아니다. 목록에 없다. 다음 메시지는 당신에게 온다: 공급사를 하나 더 붙여야 할까요?
아마 그래야 할 것이다. 하지만 호텔 API 공급사는 몇 곳이 필요한가는 커버리지 답이 나오는 커버리지 질문이 아니다. 공급사를 하나 추가할 때마다 인벤토리는 넓어지지만, 이미 갖고 있는 호텔이 다른 이름, 다른 ID, 살짝 다른 좌표로 다시 들어온다. 두 번째 연동은 대부분 코드다. 그 뒤는 대부분 중복 제거이고, 사람들이 공급사를 셀 때 빠뜨리는 비용이 바로 그것이다.
공급사 하나는 피드 하나가 아니라 둘이다
호텔 공급사는 전혀 다른 두 가지를 넘겨주며, 이를 하나로 취급하는 것이 초기 실수 대부분의 뿌리다.
첫째는 정적 콘텐츠다. 숙소명, 주소, 좌표, 성급, 사진, 객실 설명, 편의시설. 천천히 바뀐다. 일괄로 받아 저장하고, 며칠 단위 일정으로 갱신한다. 둘째는 실시간 요금이다. 이 날짜, 이 인원에 무엇이 가능하고, 얼마이며, 어떤 취소 정책이 붙는가. 검색과 예약 사이에도 바뀐다. 길어야 몇 분 캐시하고, 검색 결과가 뭐라 했든 prebook 단계에서 다시 확인한다.
즉 캐시 수명이 둘, 실패 방식도 둘이다. 오래된 정적 콘텐츠는 엉뚱한 사진을 보여 준다. 오래된 요금은 공급사가 인정하지 않을 가격에 객실을 판다. 공급사를 추가하면 두 피드를 모두 추가하는데, 진짜 일은 정적 쪽에 숨어 있다. 이미 보유한 모든 데이터와 맞춰야 하는 쪽이 그것이기 때문이다.
같은 호텔이 세 번 도착하는 이유
같은 도시에 공급사 세 곳을 연결하고 검색해 보라. 대략 이런 결과가 나온다. 한 곳은 Grand Plaza Hotel Taksim, 다른 곳은 Grand Plaza Taksim, 세 번째는 GRAND PLAZA HTL - ISTANBUL. 내부 코드 셋. 걸어서 몇 분 거리로 어긋난 좌표 셋. 사진 세트 셋, 그중 하나는 리노베이션 전 사진. 여행자 눈에는 고장 난 사이트로 보인다.
해법은 매핑 레이어이고, 중복을 제거하는 기준 필드는 이름이 아니다. 당신 자신의 표준 숙소 ID다. 각 공급사의 호텔 코드는 매핑 테이블(공급사, 공급사 호텔 코드, 표준 ID)을 통해 그 ID를 가리킨다. 공급사 코드를 카탈로그의 기본 키로 삼아서는 안 된다. 두 번째 공급사를 붙이는 순간 그 결정을 되돌리는 비용이 매우 커지기 때문이다.
두 코드가 한 호텔인지 판단하는 일은 매칭 문제이고, 깔끔한 경우는 드물다.
- 공급사들이 공통 외부 매핑 코드를 갖고 있다면 그것이 가장 강한 신호다. 모든 공급사가 갖고 있지는 않고, 모든 숙소에 있지도 않다.
- 좁은 반경 안의 좌표에 정규화한 이름("hotel", 도시명, 문장 부호, 대소문자 제거)을 더하면 나머지 대부분을 잡는다.
- 주소와 전화번호가 애매한 경우를 가른다. 한 거리에 있는 같은 체인의 두 지점이야말로 이름과 거리가 일치하면서 호텔은 다른 경우다.
- 남는 것은 사람이 검토하는 큐로 보낸다. 추측으로 라이브에 올리지 않는다.
객실은 호텔보다 어렵다
숙소를 매핑해도 객실은 여전히 맞지 않는다. "Deluxe King", "Superior Room, 1 King Bed", "Double Room - City View"는 같은 객실일 수도, 서로 다른 셋일 수도 있다. 대부분의 팀은 공급사별 객실명을 전부 매핑하려 하기보다 숙소 단위에서 식사 타입, 취소 조건, 가격으로 객실 오퍼를 비교한다. 변호할 수 있는 선택이다. 다만 의도적으로 결정하고, 여행자가 무엇을 예약하는지 알 수 있을 만큼 공급사의 객실 설명을 보여 주어야 한다.
공급사 하나, 여럿, 아니면 애그리게이터
길은 셋이고, 정직한 비교는 누가 매핑과 요금 불일치 위험을 떠안는가에 관한 것이지 브로슈어의 커버리지에 관한 것이 아니다.
| 커버리지 | 요금 불일치 위험 | 연동 공수 | 매핑 담당 | |
|---|---|---|---|---|
| 공급사 하나, 직접 연동 | 그 공급사가 강한 곳에서 강하고, 그 외는 얇음 | 높음: 가격이 어긋나도 두 번째 견적이 없음 | 연동 하나, 피드 둘 | 필요 없음, 호텔당 코드 하나 |
| 공급사 여럿, 직접 연동 | 통제 가능한 범위에서 가장 넓음 | 낮음: 숙박 건마다 더 나은 견적 선택 가능 | 공급사마다 하나, 매핑 레이어, 그 유지보수까지 | 당신이, 영구히 |
| 애그리게이터 | 넓지만 애그리게이터의 소스가 결정 | 혼합: 그쪽이 넘기기로 한 가격만 보임 | 연동 하나 | 애그리게이터, 새는 것은 당신이 판단 |
가운데 행에 동의하지 않아도 되고, 많은 팀이 그렇다. 매핑을 소유한다는 것은 검색 결과의 품질을 소유한다는 뜻이고, 그것을 절대 넘기지 않으려는 팀도 있다. 요점은 이것이 기술 결정인 만큼 인력 결정이기도 하다는 것이다. 매핑 테이블은 종료일이 있는 프로젝트가 아니다.
숫자를 정하는 법
공급사가 아니라 시장을 세라. 가장 많이 파는 곳에서 강한 공급사 하나로 시작하라. 비어 있거나 빈약하게 돌아온 검색과 영업팀이 전달한 스크린샷을 기록으로 남겨라. 첫 공급사가 놓치는 도시와 숙소를 이름으로 댈 수 있을 때 두 번째를 추가하고, 서명하기 전에 후보가 실제로 그곳을 커버하는지 확인하라.
추가할 때마다 목록으로 적을 수 있는 공백을 하나씩 닫아야 한다. 적을 수 없다면 새 공급사는 이미 팔고 있는 호텔의 중복을 보내는 데 그친다. 여행 API를 브로슈어가 아니라 축으로 평가하는 법은 따로 썼고, 그 틀은 여기의 모든 후보에 적용된다.
전부 직접 연동하지 않는 길
네 번째 길이 있다. 공급사 연결을 이미 보유한 플랫폼에 한 번만 연동하는 것이다. 이 플랫폼에서 공급사 콘텐츠는 일대일 계약이 아니라 공급사 그룹을 통해 공유되고, tenant는 자기 그룹이 허용한 공급사를 본다. 개발자에게 이는 "내 호텔 검색 뒤에 어떤 공급사가 있는가"라는 질문을 코드에서 설정으로 옮긴다. 호텔 API 하나에 맞춰 개발하고, 공급사 구성은 또 한 번의 연동 스프린트가 아니라 상업적 합의가 된다.
이 글의 질문이 사라지는 것은 아니다. 부여받을 공급사들의 매핑이 어떻게 처리되는지 묻고, 데모 도시가 아니라 실제로 파는 도시에서 테스트하라. 항공·호텔 API 접근은 셀프서비스 키가 아니라 대화로 시작하며, 바로 그 질문을 던지기에 맞는 순간이다.
연동이 부족하면 치르는 비용
스크린샷 속 빠진 호텔은 예약 한 건의 손실이 아니다. 이제 메시지를 보내기 전에 휴대폰부터 확인하는 고객이고, 몇 번 더 겪고 나면 메시지를 보내는 대신 확인만 하는 고객이다. 에이전시는 서비스에서 잘못한 게 없다. 검색이 그 숙소의 존재를 몰랐을 뿐이다.
과한 연동은 다른 식으로 비용을 치른다. 결과에 같은 호텔이 세 줄, 카운터에서 설명해야 할 취소 정책 셋, 계약 셋, 교체해야 할 자격 증명 세 세트. 두 실패 모두 공급사 수에는 드러나지 않는다. 둘 다 여행자가 결과 페이지에서 보는 것에 드러난다.
실시간 요금 쪽은 느린 공급사를 견디도록 만들어라. 호텔 객실 가용성 클라이언트 설계에서 다루었다. 그다음, 이름을 댈 수 있는 공백이 그 뒤에 공급사 몇 곳이 설지 결정하게 하라.