Перейти до вмісту
Блог

Безкоштовний API бронювання готелів: що він дає насправді

Редакція Tekravel
Написано за допомогою ШІ

Четвер, друга половина дня, а демо в понеділок. Ви знайшли безкоштовний API бронювання готелів, зареєструвалися з адресою електронної пошти і за п'ять хвилин мали ключ. Endpoint пошуку повертає готелі з фото, зірками та ціною за ніч. До вечора сторінка результатів виглядає саме так, як треба. У п'ятницю ви підключаєте виклик бронювання, і він відповідає помилкою, яку неможливо прочитати, бо те, на що ви підписалися, ніколи не вміло робити бронювання.

Вам ніхто не брехав. Слово «безкоштовний» на цьому ринку просто приклеєне до чотирьох різних продуктів, а сторінки реєстрації не кажуть, який саме у вас у руках.

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

Цю таблицю варто тримати біля клавіатури. Якщо ваш постачальник у якомусь рядку працює інакше, сперечайтеся з нею; це теж корисна знахідка.

Що таке безкоштовна пропозиціяЩо ви отримуєтеЩо можна побудуватиЧого вона не вміє
Статичний контент або довідкові даніНазви готелів, адреси, фото, зручності, описиПутівник готелями, мапу, сторінку напрямкуПоказати ціну, за яку ви можете відповідати, або номер, справді вільний на ваші дати
Партнерський пошук із переадресацієюГотелі й ціни та посилання назовні на власний checkout продавцяСторінку порівняння, що відправляє трафік деіндеУтримати на вашому боці клієнта, оплату чи запис бронювання
Sandbox із тестовими тарифамиПовні виклики пошуку, ціни, бронювання та скасування, що відповідають вигаданим наявним фондомРобочу інтеграцію та демо, що поводиться як productionСтворити бронювання, яке визнає справжній готель
Живі тарифи для бронюванняСправжні номери за справжніми net- або продажними цінами, підтверджені постачальникомМагазин, що бере гроші за номериБути безкоштовним для того, хто підписує контракт

Перші три безкоштовні, бо роздавати їх постачальнику майже нічого не коштує. Четвертий не безкоштовний, бо хтось несе справжній тягар.

Чому тариф для бронювання завжди приходить із контрактом

Коли ваш клієнт платить за номер, запускається ланцюг зобов'язань. Постачальник тримає контракт із готелем. Цей постачальник пообіцяв готелю, що номер буде оплачено, а вам — що номер існує. Якщо гість скасовує після дати безкоштовного скасування, хтось винен готелю ніч. Якщо тариф був хибний, хтось покриває різницю. Якщо картку було вкрадено, хтось лишається з chargeback.

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

Це не критика безкоштовних тарифних планів. Потік контенту — саме те, що треба для путівника напрямком. Він хибний лише тоді, коли його приймають за те, що потрібно, аби прийняти бронювання.

Якщо ви ще й вирішуєте, скільки постачальників потрібно за тим, кого оберете, ми розібрали це в статті скільки готельних API-постачальників потрібно; авіаверсія тієї ж плутанини — у статті три типи безкоштовного API авіаквитків.

У першому рядку є ще одна пастка. Статичний контент і живі тарифи — два потоки з різним терміном життя: опис готелю може тижнями лежати у вашому cache, а тариф на сьогоднішню ніч не може лежати там і хвилин. Безкоштовний потік контенту, який ще й показує ціну, називає число, за яке не відповідатиме, а сторінка на ньому радісно покаже номер, проданий учора.

Що перевірити в sandbox до підписання будь-якого контракту

Sandbox — найкорисніша безкоштовна річ у таблиці, тож використовуйте його на повну. Хороший sandbox дає пройти кожен крок справжнього бронювання з фондом підробленим, але у формі справжнього.

  1. Шукайте з дітьми та кількома номерами. Розміщення — місце, де прості інтеграції ламаються першими. Попросіть два номери з різними гостями й подивіться, чи відповідь тримає їх окремо.
  2. Перевірте ціну перед бронюванням. Багато постачальників очікують другий виклик, що підтверджує чинність тарифу. Якщо в sandbox такого кроку немає, спитайте, чи є він у production.
  3. Забронюйте, а потім прочитайте, що повернулося. Підтверджений номер, запит в очікуванні та номер на запит — три різні результати, і ваш екран має сказати, який із них.
  4. Змініть тариф між пошуком і бронюванням. Тарифи рухаються. Як виглядає помилка, і чи вміє ваш код показати клієнту нову ціну замість порожньої сторінки?
  5. Скасуйте в межах безкоштовного вікна і поза ним. Умови скасування мають приходити як структуровані дані з датами та сумами, а не як абзац, який треба парсити.
  6. Навмисно зламайте. Надішліть хибну дату, невідомий код готелю, прострочений token. Порахуйте, скільки різних форм помилки повертається.

Якщо sandbox не вміє кроків чотири і п'ять, у вас контентний API з URL, що лише схожий на бронювання.

Скільки коштує будувати на хибному типі

Дорога версія цієї помилки — не втрачений тиждень. Це демо, яке пройшло добре.

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

Дешевша звичка — поставити одне питання, перш ніж писати код: «Чи може цей ключ створити бронювання, яке визнає готель, а потім скасувати його?» Якщо відповідь щось інше, ніж «так», ви знаєте, котру з чотирьох тримаєте.

Де стоїть ця платформа

Про власну позицію ми маємо говорити так само відверто, як про інших. Платформа надає API авіаквитків і готелів, а доступ починається з розмови, а не з ключа самообслуговування. Це четвертий рядок таблиці: за фондом для бронювання стоїть хтось, кому треба знати, хто питає. Якщо хочете побачити, як це працює для вашого проєкту, почніть зі сторінки туристичних API і розкажіть нам, що ви будуєте.

Безкоштовний контент, партнерські посилання й sandbox мають кожен своє місце, а правильний вибір залежить від того, що ви збираєтеся продавати. Обирайте за тим, що вміє ключ того дня, коли клієнт платить.

Редакція Tekravel

Відділ travel-технологій

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