API бронювання готелів і авіаквитків: одна подорож, два бронювання

У тікеті написано: "додати готелі до сценарію рейсів, один checkout, одна сума". Розумне прохання від продакт-менеджера, і звучить як робота на день, бо пошук рейсів у вас уже є і сторінка оплати теж. Через три тижні команда сперечається, що має статися, коли авіакомпанія підтверджує, а готель ні. API бронювання готелів і авіаквитків — це не одна інтеграція з двома видами результатів. Це дві інтеграції, що ділять один кошик.
Що раніше код це визнає, то менше його доведеться переписувати. Далі — частина, яку посібники з інтеграції пропускають: чим відрізняються дві половини, яку з них фіксувати першою і чим має бути подорож у вашій моделі даних.
Дві половини поводяться по-різному
Обидві повертаються як JSON із ціною та референсом, тож у мережі виглядають схоже. Але не схожі в тому, що обіцяють, коли референс уже у вас.
| Питання | Рейс | Готель |
|---|---|---|
| Що у вас після бронювання | Бронювання (PNR), яке ще не є квитком | Підтвердження, яке зазвичай уже і є проданим продуктом |
| Скільки діє ціна | Доки тариф не перерахують під час бронювання, і він може відрізнятися від пошуку | Доки не спливе тариф, а тариф може змінитися між доступністю та бронюванням |
| Що його підтверджує | Виписка квитка, часто з обмеженням у часі | Підтвердження постачальника, іноді миттєве, іноді в очікуванні |
| Як його скасувати | Void, якщо встигнути рано, інакше повернення за правилами тарифу, часто зі штрафом | Скасування за політикою самого тарифу, у багатьох тарифах безкоштовне до певного строку |
| Що змінює суму наприкінці | Тариф, збори, іноді валюта тарифу | Податки й збори, що сплачуються в готелі, тип харчування, фактично наданий номер |
Ви можете не погодитися з якимось рядком, бо постачальники різні, але не з формою: одна половина має крок виписки квитка, інша має вікно скасування, і в часі вони не збігаються. Авіаційний бік цієї послідовності ми розібрали в інтеграції API бронювання авіаквитків, а проблему повільного постачальника на боці готелів — у дизайні клієнта API доступності готелів. Цей текст починається там, де ті закінчуються: на стику.
Що бронювати першим?
Ніхто не скаже вам, що це рішення дизайну, а саме воно визначає, скільки коштує збій.
Припустімо, клієнт купує рейс і готель на ті самі дати. Ви надсилаєте одне бронювання, потім інше. Може статися три речі: обидва вдаються, або одне не вдається, або одне не вдається після того, як інше вже вдалося. Перше — гарний день. Два інші визначають вашу чергу підтримки.
Якщо спершу виписати квиток, а готель потім відмовить, у вас клієнт із місцем у літаку до міста і без номера, з якого вже списали гроші, і повернення за квиток зі штрафом. Якщо спершу забронювати готель, а рейс потім не вдасться, ви тримаєте номер, який часто можна скасувати безкоштовно, тож виправлення дешеве. Зворотний ризик теж реальний, бо неповоротний тариф готелю — найгірше, що можна тримати, тож прочитайте умови скасування тарифу, перш ніж пускати його першим.
Це практичне правило, а не закон, і суть у тому, щоб обрати порядок свідомо. Фіксуйте половину, яку легше скасувати, перед тією, яку важче, перевіряйте ціну обох безпосередньо перед фіксацією будь-якої і запишіть, що ви робите в кожному з трьох випадків. Рев'юери рідко питають. Клієнти завжди дізнаються.
Одна подорож, два бронювання
Форма, що витримує навантаження, — це запис подорожі, якому належать два бронювання, кожне з власним референсом, власним статусом і власними умовами. Клієнт бачить одну суму. Ваша база бачить два рядки, а сума — це те, що ви обчислюєте, а не те, що існує в постачальника.
Тримайте два статуси окремо. "Підтверджено" для готелю і "виписано" для рейсу — не один і той самий стан, і одна колонка статусу, яка їх сплющує, рано чи пізно напише "заброньовано" над наполовину заброньованою подорожжю.
Тримайте окремо й два набори умов зміни, і показуйте їх. Показана сума приховує, що перенести дати в одній половині безкоштовно, а в іншій платно. Якщо ваш front-end показує "змінити дати" однією кнопкою, вирішіть, що вона робить, коли зрушити можна лише одну половину, перш ніж клієнт з'ясує це за вас. Те саме стосується націнки: якщо ви додаєте її за кожною послугою, як роблять більшість продавців, сума подорожі — це дві націнки, і повернення за одну половину має знати, яку націнку воно повертає. Гроші — це місце, де поєднана подорож стає дорогою, бо позиції розраховуються в різні строки, а повернення за рейс приходить не тоді, коли приходить скасування готелю.
Де ця платформа
Прямо: платформа надає API рейсів і готелів, а доступ починається з розмови, а не з ключа самообслуговування. Сервіси вмикаються для кожного tenant окремо, тож tenant, що продає готелі, а не тури, не несе з собою турової частини. Ніщо тут не обіцяє одного виклику, який атомарно бронює обидві половини, і не проєктуйте так, ніби обіцяє. Ставтеся до них як до двох бронювань, якими вони є, у межах подорожі, що належить вам.
Якщо хочете побачити справжні виклики й умови, перш ніж будувати на них, почніть зі сторінки travel API і принесіть порядок, у якому збираєтеся бронювати. Якщо ще вирішуєте, що дає безкоштовний доступ, безкоштовний API бронювання готелів розкладає види "безкоштовного".
Скільки коштує помилка
Дорога версія — тиха. Клієнт має квиток до міста, номера вже немає, і перше, що ви про це чуєте, — повідомлення вночі з аеропорту. Дешевше, але все одно реально: checkout, що показує одну заспокійливу суму, а потім, після перевірки ціни, другу, на яку клієнт не погоджувався; повернення, яке повертає рейс і забуває про готель; і статус "заброньовано", тоді як постачальник каже інше.
Ніщо з цього не потребує хитрого рішення. Потрібно, щоб подорож була справжнім об'єктом, щоб порядок був рішенням, яке хтось записав, і щоб обидві ціни перевірялися ще раз в останню мить перед фіксацією будь-якої. Збудуйте це один раз, і checkout може виглядати так просто, як просив тікет.