Найкращий API бронювання авіаквитків: спершу скажіть, що будуєте

Завдання звучить так: знайти найкращий API бронювання авіаквитків. Ви відкриваєте три сторінки з порівняннями, і вони розставляють ту саму жменю назв у трьох різних порядках, кожна з таблицею, повною галочок. На третій сторінці помічаєте, чого не спитала жодна: що відбувається з клієнтом після того, як повернулися результати пошуку.
Це відсутнє питання і є всією відповіддю. Найкращий API бронювання авіаквитків для сторінки, що відправляє відвідувачів на сайт авіакомпанії, — поганий вибір для сайту, який сам приймає бронювання й оплату карткою. І жоден із них не підходить для внутрішнього інструмента, яким персонал агенції користується весь день. Пошук, ціна й бронювання однакові в будь-якій документації. Відмінності лежать під ними, і яка з них вдарить по вас, залежить тільки від продукту.
Три продукти, які всі називають «сайтом бронювання авіаквитків»
Перший — сторінка порівняння або натхнення: показує тарифи, веде за посиланням далі, ніколи не торкається квитка. Тут API — майже лише пошук. Вам важливо, наскільки широкі й свіжі результати і чи достатньо близька показана ціна до тієї, яку відвідувач побачить після переходу. Вашій системі ніколи не доведеться робити void, повернення чи переоформлення, тож сила постачальника в цьому для вас марна.
Другий продає. Відвідувач платить вам, ви бронюєте, і з цієї миті життєвий цикл бронювання ваш: підтвердити ціну до списання, впоратися з авіакомпанією, що відповідає повільно, анулювати в той самий день, повернути гроші пізніше, переоформити, коли клієнт змінює дату. Для цього продукту ендпоінт пошуку — легка частина. Те, що вирішує вибір, іде після нього.
Третій — власний інструмент агенції для персоналу, який уже має стосунки з постачальниками. Сирий пошук тут не головне. Важливо, щоб з'являвся власний узгоджений агенцією контент, щоб субагенти трималися кредитних лімітів, щоб націнки застосовувалися до того, як хтось побачить ціну, і щоб наприкінці місяця були звіти. API, що чудово працює для другого продукту, тут усе одно може бути хибною основою.
Варто сказати прямо: один і той самий API не може бути найкращим у всіх трьох. Якщо рейтинг стверджує протилежне, він не стикався з другим.
Властивості, які варто порівнювати, і хто на них спирається
Зріжте таблицю функцій до рядків, щодо яких розробник справді міг би не погодитися. Кожен продукт спирається на свою підмножину, решту можна спокійно ігнорувати.
| Властивість | Сторінка-перенаправлення | Продає і приймає оплату | Інструмент персоналу агенції |
|---|---|---|---|
| Наскільки застарілою може бути показана ціна до підтвердження | Трохи важливо | Вирішально: ви за нею списуєте | Важливо, персонал за нею котирує |
| Що повертає бронювання, коли авіакомпанія відповідає повільно | Не стосується | Вирішально | Важливо |
| Хто може анулювати й повернути кошти і як це запитується | Не стосується | Вирішально | Вирішально |
| Як розв'язується бронювання з невідомим результатом | Не стосується | Вирішально: картку вже могли списати | Важливо |
| Чи діють власний контент і кредитні правила агенції | Не стосується | Іноді | Вирішально |
| Наскільки тестова поведінка відрізняється від бойової | Низько | Високо | Високо |
Читайте свою колонку й ігноруйте решту. Помилка, що коштує грошей: читати колонку перенаправлення, бо її найлегше оцінити, а будувати другий продукт.
Ціна, яку ви показуєте, ще не та, яку списуєте
Візьміть другий продукт і простежте в ньому один тариф. Пошук повертає ціну. Відвідувач дивиться на неї, думає, відкриває іншу вкладку й повертається. Через якийсь час натискає кнопку. Між пошуком і кнопкою тариф лежав у вашій системі, і єдине чесне питання до будь-якого API — що він скаже, коли ви спитаєте знову саме в цю мить.
Постачальник може дати три відповіді. Може підтвердити показану ціну. Може повернути нову, і ваш код мусить вирішити: списати різницю, спитати клієнта чи зупинитися. Або може сказати, що тарифу вже немає. Сайт, підготовлений лише до першої відповіді, працює на кожній демонстрації й ламається в наступні тижні, причому так, що це коштує грошей, а не викидає помилки.
Тож питання проєктування не в тому, чи має API крок підтвердження ціни. Майже всі мають. Питання в тому, як виглядає відповідь у всіх трьох випадках і чи може ваш код розрізнити їх без здогадок. Попросіть приклад кожного. Постачальник, який показує другий і третій у документації, думав про ваш продукт. Той, що показує лише перший, думав про демонстрацію.
Тест на один вечір, якого не дасть жодна таблиця
Хоч яким буде короткий список, проведіть з кожною назвою той самий короткий тест і навмисно викличте збої. Забронюйте щось і подивіться, що зберігає об'єкт бронювання після виписки квитка. Перевірте ціну того самого маршруту двічі з інтервалом у кілька хвилин і порівняйте другу відповідь із першою. Скасуйте, потім попросіть повернення й зафіксуйте, кому доводиться діяти. Потім письмово поставте постачальнику два питання: що повертає ваша система, коли авіакомпанія не відповідає посеред бронювання, і як мені дізнатися, що насправді сталося.
Письмові відповіді варті більше за демонстрацію. Постачальник із чіткою процедурою для невідомого результату вже стикався з проблемою. Той, хто відповідає назвою функції, — ні.
Як скласти сам план тестування, розповідає план тестування в пісочниці, зокрема про те, чого пісочниця вам не покаже. А якщо ви зважуєте постачальників за тим, що стоїть за API, а не за самим API, це окреме питання з окремою статтею; ця лишається при продукті.
Скільки коштує вибір за списком ендпоінтів
Збої тихі. Сайт підтверджує ціни запізно, тож різниця між показаним і реальним тарифом іде з вашої маржі, бронювання за бронюванням. Бронювання застрягає в невідомому стані, а картку клієнта вже списано, і хтось мусить розбиратися вручну, зазвичай поштою, зазвичай у вихідні. Інструмент, побудований на контенті лише для пошуку, виявляється таким, з якого персонал не може виписувати квитки, і проєкт перебудовують під інший контент.
Нічого з цього не видно в таблиці з галочками. Усе було видно в першій колонці таблиці вище, ще до першого рядка коду.
Наша власна позиція вужча, ніж дозволив би заявити рейтинг. Tekravel надає API авіаквитків і готелів, доступ починається з розмови, а не з ключа самообслуговування, сервіси вмикаються для кожного tenant окремо, а контент постачальників доходить до tenant через групи постачальників. Це пасує другому й третьому продуктам. Якщо ви будуєте перший, ми вам, можливо, взагалі не потрібні. Якщо будуєте один з інших, сторінка API — місце, щоб почати розмову.