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

Четверг, вторая половина дня, демо в понедельник. Вы нашли бесплатный API бронирования отелей, зарегистрировались по электронной почте и за пять минут получили ключ. Метод поиска возвращает отели с фотографиями, звёздами и ценой за ночь. К вечеру страница результатов выглядит как надо. В пятницу вы подключаете вызов бронирования, и он отвечает ошибкой, которую не прочесть, потому что то, на что вы зарегистрировались, никогда не умело ничего бронировать.
Никто вас не обманывал. Слово «бесплатный» на этом рынке приклеено к четырём разным продуктам, а страницы регистрации не говорят, какой из них у вас в руках.
Четыре значения слова «бесплатный»
Эту таблицу стоит держать рядом с клавиатурой. Если ваш поставщик устроен иначе, оспорьте строку; это тоже полезная находка.
| Что за бесплатное предложение | Что вы получаете | Что можно построить | Чего оно не может |
|---|---|---|---|
| Статический контент или справочные данные | Названия отелей, адреса, фото, удобства, описания | Путеводитель по отелям, карту, страницу направления | Показать цену, за которую вы отвечаете, или номер, реально свободный на ваши даты |
| Партнёрский поиск с переходом | Отели, цены и ссылка на кассу продавца | Страницу сравнения, уводящую трафик | Оставить клиента, платёж или запись о бронировании у вас |
| Песочница с тестовыми тарифами | Все вызовы поиска, расчёта цены, бронирования и отмены с выдуманным наполнением | Рабочую интеграцию и демо, ведущее себя как продакшен | Создать бронь, которую признает настоящий отель |
| Живые бронируемые тарифы | Настоящие номера по настоящим нетто- или продажным ценам, подтверждённые поставщиком | Магазин, принимающий деньги за номера | Быть бесплатными для того, кто подписывает договор |
Первые три бесплатны, потому что почти ничего не стоят поставщику. Четвёртый не бесплатен, потому что кто-то несёт реальный груз.
Почему бронируемый тариф всегда идёт с договором
Когда клиент платит за номер, начинается цепочка обязательств. У поставщика есть договор с отелем. Он пообещал отелю, что номер оплатят, и пообещал вам, что номер существует. Если гость отменит после даты бесплатной отмены, кто-то должен отелю ночь. Если тариф был неверным, кто-то покрывает разницу. Если карта украдена, кто-то отвечает за чарджбэк.
Всё это должно лечь на названную сторону. API-ключ, который любой создаёт по почте, этого нести не может, поэтому бронируемый доступ идёт с соглашением, схемой расчётов и нередко с кредитным лимитом. Цена «бесплатного» ключа в том, что поставщику не нужно заботиться, что вы с ним делаете.
Это не критика бесплатных тарифов. Поток контента идеально подходит путеводителю. Ошибка лишь в том, чтобы принять его за то, что нужно для приёма брони.
Если вы ещё решаете, сколько поставщиков нужно за выбранным, мы разобрали это в материале сколько нужно поставщиков API отелей; авиационная версия той же путаницы описана в трёх типах бесплатного API авиабилетов.
В первой строке есть ещё одна ловушка. Статический контент и живые тарифы — два потока с разным сроком жизни: описание отеля может неделями лежать в кэше, цена на сегодняшнюю ночь не продержится и минут. Бесплатный поток контента, показывающий ещё и цену, называет число, за которое не отвечает, и страница на нём бодро покажет номер, проданный вчера.
Что тестировать в песочнице до подписания любого договора
Песочница — самое полезное из бесплатного в таблице, поэтому используйте её жёстко. Хорошая позволяет пройти каждый шаг настоящего бронирования, с выдуманным наполнением, но той же формы.
- Ищите с детьми и несколькими номерами. Простые интеграции ломаются сначала на размещении. Запросите два номера с разными гостями и посмотрите, разделяет ли их ответ.
- Проверяйте цену перед бронированием. Многие поставщики ждут второго вызова, подтверждающего, что тариф ещё действует. Если в песочнице такого шага нет, спросите, есть ли он в продакшене.
- Забронируйте и прочтите ответ. Подтверждённый номер, ожидающий запрос и номер по запросу — три разных исхода, и ваш экран должен сказать, какой именно.
- Измените тариф между поиском и бронированием. Тарифы меняются. Как выглядит ошибка и может ли ваш код показать клиенту новую цену вместо пустой страницы?
- Отмените внутри и вне бесплатного окна. Условия отмены должны приходить структурированными данными с датами и суммами, а не абзацем, который придётся разбирать.
- Ошибитесь нарочно. Отправьте неверную дату, неизвестный код отеля, просроченный токен. Посчитайте, сколько разных форм ошибок вернётся.
Если песочница не умеет шагов четыре и пять, у вас API контента с URL в форме бронирования.
Во что обходится сборка на неправильном виде
Дорогая версия этой ошибки — не потерянная неделя. Это демо, которое прошло хорошо.
Вы показываете руководителю аккуратную страницу поиска, он утверждает бюджет, и только тогда команда выясняет, что источник за ней не умеет подтверждать номер. Код пропадает не весь, но сценарий бронирования, шаг оплаты, обработку отмен и расчёты придётся строить заново на другом поставщике с другими названиями полей. Показанная страница поиска будет возвращать уже другие отели, по другим ценам, в другом порядке. Тот, кто утвердил бюджет, это заметит.
Дешевая привычка — задать один вопрос до первой строки кода: «Может ли этот ключ создать бронь, которую признает отель, и затем отменить её?» Если ответ не «да», вы знаете, какой из четырёх видов у вас.
Где стоит эта платформа
О своей позиции нужно говорить так же прямо, как о чужих. Платформа предоставляет API авиабилетов и отелей, и доступ начинается с разговора, а не с ключа самообслуживания. Это четвёртая строка таблицы: за бронируемым наполнением стоит тот, кому нужно знать, кто спрашивает. Если хотите увидеть, как это выглядит для вашего проекта, начните со страницы API для путешествий и расскажите, что строите.
У бесплатного контента, партнёрских ссылок и песочниц есть своё место, и правильный выбор зависит от того, что вы собираетесь продавать. Выбирайте по тому, что ключ умеет в день, когда платит клиент.