무료 호텔 예약 API, 무료가 실제로 주는 것

목요일 오후인데 데모는 월요일입니다. 무료 호텔 예약 API를 찾았고, 이메일로 가입해 5분 만에 키를 받았습니다. 검색 엔드포인트는 사진, 성급, 1박 가격이 담긴 호텔을 돌려줍니다. 저녁이 되면 결과 페이지는 그럴듯해 보입니다. 금요일에 예약 호출을 연결하면 읽을 수 없는 오류가 돌아옵니다. 가입한 상품이 애초에 예약을 만들 수 없는 것이었기 때문입니다.
누가 거짓말한 것은 아닙니다. 이 시장에서 ‘무료’는 서로 다른 네 가지 상품에 그냥 붙어 있고, 가입 페이지는 어느 것을 쥐고 있는지 알려주지 않습니다.
‘무료’의 네 가지 뜻
이 표는 키보드 옆에 두고 볼 만합니다. 공급사가 어떤 행에서 다르다면 그것도 쓸모 있는 발견입니다.
| 무료 제안의 정체 | 얻는 것 | 만들 수 있는 것 | 할 수 없는 것 |
|---|---|---|---|
| 정적 콘텐츠 또는 디렉터리 데이터 | 호텔명, 주소, 사진, 편의시설, 설명 | 호텔 가이드, 지도, 목적지 페이지 | 보장할 수 있는 가격이나 해당 날짜에 실제로 비어 있는 객실 보여주기 |
| 리디렉션하는 제휴 검색 | 호텔과 가격, 판매처 자체 결제 페이지로 가는 링크 | 트래픽을 다른 곳으로 보내는 비교 페이지 | 고객, 결제, 예약 기록을 자기 쪽에 두기 |
| 테스트 요금이 있는 샌드박스 | 가상 재고로 응답하는 검색, 가격, 예약, 취소 호출 전체 | 실제 운영처럼 동작하는 연동과 데모 | 실제 호텔이 인정하는 예약 만들기 |
| 예약 가능한 실시간 요금 | 공급사가 확인한 실제 객실, 실제 net 또는 판매가 | 객실 대금을 받는 상점 | 계약서에 서명하는 쪽에 무료이기 |
앞의 세 가지는 제공자가 내주는 데 거의 비용이 들지 않아서 무료입니다. 네 번째는 누군가 실제 위험을 지고 있어서 무료가 아닙니다.
예약 가능한 요금에는 왜 항상 계약이 따르는가
고객이 객실 값을 치르는 순간 의무의 사슬이 시작됩니다. 공급사는 호텔과 계약을 맺고 있습니다. 호텔에는 객실 대금이 지급될 것이라고, 당신에게는 그 객실이 존재한다고 약속했습니다. 무료 취소 기한이 지난 뒤 투숙객이 취소하면 누군가 호텔에 하룻밤 값을 빚집니다. 요금이 잘못됐다면 누군가 차액을 떠안습니다. 카드가 도용됐다면 누군가 차지백을 책임집니다.
이 모든 것은 이름이 있는 당사자에게 귀속되어야 합니다. 이메일 주소만으로 누구나 만들 수 있는 API 키는 이를 감당할 수 없고, 그래서 예약 가능한 접근에는 계약, 정산 약정, 종종 신용 한도가 따라옵니다. ‘무료’ 키의 대가는 제공자가 당신이 그것으로 무엇을 하든 신경 쓸 필요가 없다는 점입니다.
무료 플랜을 비판하는 것이 아닙니다. 콘텐츠 피드는 목적지 가이드에 꼭 맞습니다. 예약을 받는 데 필요한 것으로 착각할 때만 틀린 선택이 됩니다.
선택한 공급사 뒤에 공급사가 몇 곳 더 필요한지도 고민 중이라면 호텔 API 제공업체가 몇 개 필요한지에 관한 글에서 다뤘고, 같은 혼동의 항공편 버전은 무료 항공편 API 세 가지에 관한 글에 있습니다.
첫 번째 행 안에 함정이 하나 더 있습니다. 정적 콘텐츠와 실시간 요금은 수명이 다른 두 개의 피드입니다. 호텔 설명은 캐시에 몇 주 머물 수 있지만 오늘 밤 요금은 몇 분도 머물 수 없습니다. 가격까지 보여주는 무료 콘텐츠 피드는 책임지지 않을 숫자를 인용하는 것이고, 그 위에 지은 페이지는 어제 매진된 객실을 태연히 보여줄 것입니다. 거래 상대가 누구인지 모르는 채로 객실을 팔 수 있는 사람은 없습니다. 그래서 예약 기능이 있는 키는 처음부터 누가 쓰는지 알고 발급됩니다.
계약 전에 샌드박스에서 테스트할 것
샌드박스는 표에서 가장 쓸모 있는 무료 항목이니 충분히 활용하세요. 좋은 샌드박스는 실제 예약의 모든 단계를, 가짜지만 진짜와 같은 모양의 재고로 해볼 수 있게 해줍니다.
- 아동과 여러 객실로 검색하기. 투숙 인원은 단순한 연동이 가장 먼저 깨지는 곳입니다. 서로 다른 투숙객이 있는 객실 두 개를 요청하고 응답이 구분해 주는지 보세요.
- 예약 전 가격 확인. 많은 공급사가 요금이 아직 유효한지 확인하는 두 번째 호출을 기대합니다. 샌드박스에 그 단계가 없다면 운영 환경에는 있는지 물어보세요.
- 예약하고 돌아온 응답 읽기. 확정된 객실, 대기 중인 요청, 요청 시 확정 객실은 서로 다른 세 가지 결과이며 화면이 어느 쪽인지 말해줘야 합니다.
- 검색과 예약 사이에 요금 바꾸기. 요금은 움직입니다. 오류는 어떤 모양이고, 코드가 빈 페이지 대신 새 가격을 고객에게 보여줄 수 있나요?
- 무료 기간 안과 밖에서 취소하기. 취소 정책은 직접 파싱해야 하는 문단이 아니라 날짜와 금액이 담긴 구조화된 데이터로 와야 합니다.
- 일부러 실패시키기. 잘못된 날짜, 모르는 호텔 코드, 만료된 토큰을 보내세요. 오류의 형태가 몇 가지로 돌아오는지 세어 보세요.
샌드박스가 네 번째와 다섯 번째 단계를 못 한다면, 가진 것은 예약처럼 생긴 URL을 가진 콘텐츠 API입니다.
잘못된 종류 위에 만들면 드는 비용
이 실수의 비싼 버전은 잃어버린 한 주가 아닙니다. 잘 끝난 데모입니다.
이해관계자에게 깔끔한 검색 페이지를 보여주고 예산이 승인된 뒤에야, 그 뒤의 소스가 객실을 확정할 수 없다는 사실을 팀이 알게 됩니다. 코드가 전부 버려지는 것은 아니지만 예약 흐름, 결제 단계, 취소 처리, 정산은 필드 이름이 다른 공급사에 맞춰 다시 만들어야 합니다. 보여줬던 검색 페이지는 다른 호텔을 다른 가격과 다른 순서로 돌려줄 것입니다. 예산을 승인한 사람은 알아챕니다.
더 싼 습관은 코드를 한 줄 쓰기 전에 한 가지를 묻는 것입니다. “이 키로 호텔이 인정하는 예약을 만들고, 나중에 취소할 수 있습니까?” 답이 ‘예’가 아니라면 네 가지 중 무엇을 쥐고 있는지 알게 됩니다.
이 플랫폼의 위치
다른 곳에 대해 솔직했던 만큼 우리 위치에 대해서도 솔직하게 말씀드립니다. 이 플랫폼은 항공편과 호텔 API를 제공하며, 접근은 셀프서비스 키가 아니라 대화로 시작됩니다. 표의 네 번째 행입니다. 예약 가능한 재고 뒤에는 누가 묻는지 알아야 하는 사람이 있습니다. 직접 만들 프로젝트에서 어떻게 동작하는지 보고 싶다면 여행 API 페이지에서 시작해 무엇을 만들고 있는지 알려주세요.
무료 콘텐츠, 제휴 링크, 샌드박스는 각각 쓸 자리가 있으며, 올바른 선택은 무엇을 팔 계획인지에 달려 있습니다. 고객이 결제하는 날 키가 할 수 있는 일을 기준으로 고르세요.