Перейти к содержимому
Блог

Бесплатный API бронирования отелей: что он даёт на деле

Редакция Tekravel
Написано с помощью ИИ

Четверг, вторая половина дня, демо в понедельник. Вы нашли бесплатный API бронирования отелей, зарегистрировались по электронной почте и за пять минут получили ключ. Метод поиска возвращает отели с фотографиями, звёздами и ценой за ночь. К вечеру страница результатов выглядит как надо. В пятницу вы подключаете вызов бронирования, и он отвечает ошибкой, которую не прочесть, потому что то, на что вы зарегистрировались, никогда не умело ничего бронировать.

Никто вас не обманывал. Слово «бесплатный» на этом рынке приклеено к четырём разным продуктам, а страницы регистрации не говорят, какой из них у вас в руках.

Четыре значения слова «бесплатный»

Эту таблицу стоит держать рядом с клавиатурой. Если ваш поставщик устроен иначе, оспорьте строку; это тоже полезная находка.

Что за бесплатное предложениеЧто вы получаетеЧто можно построитьЧего оно не может
Статический контент или справочные данныеНазвания отелей, адреса, фото, удобства, описанияПутеводитель по отелям, карту, страницу направленияПоказать цену, за которую вы отвечаете, или номер, реально свободный на ваши даты
Партнёрский поиск с переходомОтели, цены и ссылка на кассу продавцаСтраницу сравнения, уводящую трафикОставить клиента, платёж или запись о бронировании у вас
Песочница с тестовыми тарифамиВсе вызовы поиска, расчёта цены, бронирования и отмены с выдуманным наполнениемРабочую интеграцию и демо, ведущее себя как продакшенСоздать бронь, которую признает настоящий отель
Живые бронируемые тарифыНастоящие номера по настоящим нетто- или продажным ценам, подтверждённые поставщикомМагазин, принимающий деньги за номераБыть бесплатными для того, кто подписывает договор

Первые три бесплатны, потому что почти ничего не стоят поставщику. Четвёртый не бесплатен, потому что кто-то несёт реальный груз.

Почему бронируемый тариф всегда идёт с договором

Когда клиент платит за номер, начинается цепочка обязательств. У поставщика есть договор с отелем. Он пообещал отелю, что номер оплатят, и пообещал вам, что номер существует. Если гость отменит после даты бесплатной отмены, кто-то должен отелю ночь. Если тариф был неверным, кто-то покрывает разницу. Если карта украдена, кто-то отвечает за чарджбэк.

Всё это должно лечь на названную сторону. API-ключ, который любой создаёт по почте, этого нести не может, поэтому бронируемый доступ идёт с соглашением, схемой расчётов и нередко с кредитным лимитом. Цена «бесплатного» ключа в том, что поставщику не нужно заботиться, что вы с ним делаете.

Это не критика бесплатных тарифов. Поток контента идеально подходит путеводителю. Ошибка лишь в том, чтобы принять его за то, что нужно для приёма брони.

Если вы ещё решаете, сколько поставщиков нужно за выбранным, мы разобрали это в материале сколько нужно поставщиков API отелей; авиационная версия той же путаницы описана в трёх типах бесплатного API авиабилетов.

В первой строке есть ещё одна ловушка. Статический контент и живые тарифы — два потока с разным сроком жизни: описание отеля может неделями лежать в кэше, цена на сегодняшнюю ночь не продержится и минут. Бесплатный поток контента, показывающий ещё и цену, называет число, за которое не отвечает, и страница на нём бодро покажет номер, проданный вчера.

Что тестировать в песочнице до подписания любого договора

Песочница — самое полезное из бесплатного в таблице, поэтому используйте её жёстко. Хорошая позволяет пройти каждый шаг настоящего бронирования, с выдуманным наполнением, но той же формы.

  1. Ищите с детьми и несколькими номерами. Простые интеграции ломаются сначала на размещении. Запросите два номера с разными гостями и посмотрите, разделяет ли их ответ.
  2. Проверяйте цену перед бронированием. Многие поставщики ждут второго вызова, подтверждающего, что тариф ещё действует. Если в песочнице такого шага нет, спросите, есть ли он в продакшене.
  3. Забронируйте и прочтите ответ. Подтверждённый номер, ожидающий запрос и номер по запросу — три разных исхода, и ваш экран должен сказать, какой именно.
  4. Измените тариф между поиском и бронированием. Тарифы меняются. Как выглядит ошибка и может ли ваш код показать клиенту новую цену вместо пустой страницы?
  5. Отмените внутри и вне бесплатного окна. Условия отмены должны приходить структурированными данными с датами и суммами, а не абзацем, который придётся разбирать.
  6. Ошибитесь нарочно. Отправьте неверную дату, неизвестный код отеля, просроченный токен. Посчитайте, сколько разных форм ошибок вернётся.

Если песочница не умеет шагов четыре и пять, у вас API контента с URL в форме бронирования.

Во что обходится сборка на неправильном виде

Дорогая версия этой ошибки — не потерянная неделя. Это демо, которое прошло хорошо.

Вы показываете руководителю аккуратную страницу поиска, он утверждает бюджет, и только тогда команда выясняет, что источник за ней не умеет подтверждать номер. Код пропадает не весь, но сценарий бронирования, шаг оплаты, обработку отмен и расчёты придётся строить заново на другом поставщике с другими названиями полей. Показанная страница поиска будет возвращать уже другие отели, по другим ценам, в другом порядке. Тот, кто утвердил бюджет, это заметит.

Дешевая привычка — задать один вопрос до первой строки кода: «Может ли этот ключ создать бронь, которую признает отель, и затем отменить её?» Если ответ не «да», вы знаете, какой из четырёх видов у вас.

Где стоит эта платформа

О своей позиции нужно говорить так же прямо, как о чужих. Платформа предоставляет API авиабилетов и отелей, и доступ начинается с разговора, а не с ключа самообслуживания. Это четвёртая строка таблицы: за бронируемым наполнением стоит тот, кому нужно знать, кто спрашивает. Если хотите увидеть, как это выглядит для вашего проекта, начните со страницы API для путешествий и расскажите, что строите.

У бесплатного контента, партнёрских ссылок и песочниц есть своё место, и правильный выбор зависит от того, что вы собираетесь продавать. Выбирайте по тому, что ключ умеет в день, когда платит клиент.

Редакция Tekravel

Отдел travel-технологий

Отдел travel-технологий Tekravel пишет для профессионалов рынка: владельцев агентств, консолидаторов и разработчиков, которые их интегрируют. Каждая статья проверяется на той самой платформе, которую описывает, до публикации.