Порівняння travel API: оцінюйте осі, а не постачальників

У вас відкриті три презентації постачальників у трьох вкладках. У кожній є слайд із довгим списком авіакомпаній, слайд із кількістю готелів, sandbox, REST і JSON та адреса підтримки. Ви складаєте таблицю, ставите галочку в кожній клітинці, і таблиця закінчується нічиєю. Так зазвичай завершується порівняння travel API, зроблене як чекліст функцій, і це неправильний фінал: відмінності, що визначать ваш наступний рік, з'являються лише після запуску. На бронюванні, яке в постачальника пройшло, а у вас обірвалося по таймауту. На поверненні коштів, яке ніхто не може обробити. На авіакомпанії, яка була в списку, але квиток на неї цим маршрутом виписати неможливо.
Цей текст — для розробника чи технічного лідера, якому треба ухвалити це рішення і потім його захищати. Він не складає рейтинг постачальників. Він дає осі для порівняння, план тестового періоду, що витрачає час на збої, і короткий набір питань, які швидко покажуть, чи говорите ви з постачальником, чи з перепродавцем чужого постачальника.
Чому чекліст функцій завжди закінчується нічиєю
Чекліст питає, чи існує можливість. Майже кожен travel API може відповісти «так» майже на кожен рядок, бо рядки написані на рівні маркетингової сторінки: пошук, ціна, бронювання, скасування, виписка, вебхуки, sandbox. Питання, яке їх розрізняє, — не чи існує cancel, а що станеться, коли ви викличете його на виписаному бронюванні за дванадцять годин до вильоту, на тарифі зі штрафом, через маршрут, де контент прийшов від третьої сторони. У чеклісті немає для цього стовпця.
Є й друга проблема. Заповнює чекліст зазвичай сам постачальник. Ви оцінюєте його самоопис.
Порівняння travel API за осями, а не за постачальниками
Замініть сітку «постачальник × функція» осями, які ви оцінюєте самі, на підставі доказів, зібраних на тестовому періоді. Таблиця нижче — та, якою користувалися б ми. Ви можете розставити ваги інакше — бізнесу, що продає лише готелі, виписка квитків менш важлива, — і з нею варто посперечатися, перш ніж її приймати.
| Вісь | Про що питає чекліст | Що з'ясувати насправді | Як звучить слабка відповідь |
|---|---|---|---|
| Покриття | Скільки авіакомпаній і готелів? | Скільки з них можна знайти, забронювати І виписати чи підтвердити через цей API на ваших ринках | Одне велике число без розбивки |
| Глибина | Чи є ендпоінт скасування? | Які дії після бронювання автоматизовані для кожного джерела контенту: void, повернення, переоформлення, виправлення імені, додаткові послуги | «Цим займається наш операційний відділ» |
| Достовірність ціни | Чи ціна в реальному часі? | Як часто ціна при бронюванні відрізняється від ціни пошуку і як API вам про це повідомляє | «Ціни завжди актуальні» |
| Семантика помилок | Чи задокументовано помилки? | Чи каже помилка, в якому стані бронювання, а не лише що щось пішло не так | Один загальний код на будь-який збій |
| Ідемпотентність | — | Чи може повторний виклик бронювання створити друге бронювання | Мовчання, потім «ми з таким не стикалися» |
| Постачальник за договором | — | Чий договір, чий номер IATA, через чий BSP проходить квиток | «Ми працюємо з усіма великими GDS» |
| Доступ і підтримка | Чи є sandbox? | Хто відповідає, коли завис реальний PNR, і як швидко | Форма заявки і жодної контактної особи на ім'я |
Для двох із цих рядків у чеклісті взагалі немає питання. Це не випадковість: саме ці рядки коштують найдорожче, коли щось іде не так, і саме про них комерційна презентація найменш схильна говорити з власної ініціативи.
Покриття — це не глибина
Список авіакомпаній — найоманливіший слайд будь-якої презентації. Перелік із кількох сотень перевізників може означати різні речі, і лише одна з них — те, що вам потрібно.
Частина цих перевізників приходить через GDS, і їх можна забронювати та виписати від початку до кінця. Частина приходить через NDC-підключення, де пошук може працювати добре, але обслуговування після бронювання — зміни, часткові повернення, додавання багажу — для цієї авіакомпанії досі може бути ручним. Частина — лоукости, чий контент агрегується в іншого перепродавця: їх можна показати, іноді забронювати, а потім квиток приходить маршрутом, який ви не контролюєте, у термін, який ви не можете пообіцяти клієнтові. А деякі є у списку, бо колись якийсь тариф з'явився у відповіді пошуку.
Перевізник, якого можна показати, але не можна виписати, — це не покриття. Для роздрібного продукту це гірше, ніж його відсутність: клієнт обирає, платить, а потім чекає.
У готелів та сама форма, тільки інші слова. Кількість об'єктів включає ті, що постачальник зіставив, і ті, що не зіставив; статичні ціни, закешовані минулого тижня, поруч із живою наявністю; номери в алотменті з періодом релізу поруч із фондом у вільному продажу. Попросіть кількість об'єктів, доступних для живого бронювання в містах, де ви продаєте, і запитайте, як об'єднуються дублікати між їхніми власними постачальниками: один і той самий готель, показаний тричі за трьома цінами, — це звернення в підтримку, яке лише чекає свого часу.
Практична перевірка вузька. Випишіть двадцять маршрутів і двадцять готельних міст, що дають більшість вашого обсягу — скажімо, Київ–Дубай, Варшава–Анталія, готелі в Дубаї та Шарм-ель-Шейху, — і попросіть постачальника показати саме їх у роботі від початку до кінця в sandbox: пошук, ціна, бронювання, виписка чи підтвердження, скасування. Постачальник, у якого є глибина, зробить це без зайвих розмов. Той, у кого є лише слайд, почне говорити про слайд.
Що перевіряти на тестовому періоді: шляхи помилок, а не щасливі сценарії
Будь-який sandbox успішно бронює квиток в один бік в економі на спокійному маршруті. Саме для цього його й зробили. Ваш продакшн-трафік проведе помітну частину свого життя на інших шляхах, і тестовий період — єдиний дешевий момент, щоб їх побачити.
Пройдіть на ньому цей список і записуйте, що повернув API, поруч із тим, що виявилося правдою потім:
- Зміна ціни між пошуком і бронюванням. Виклик бронювання падає, проходить за новою ціною чи повертає окрему відповідь із проханням підтвердити? Чи ваш інтерфейс розрізнить ці випадки, не розбираючи текст повідомлення?
- Прострочена пропозиція. Зробіть пошук, зачекайте довше за заявлений постачальником час життя пропозиції, потім бронюйте. Прострочення — окрема помилка чи та сама, що й «постачальник недоступний»?
- Розпродано під час бронювання. Наявність, що зникає між ціною і бронюванням. У якому стані бронювання, і чи знімається блокування платежу?
- Повтор після таймауту. Надішліть запит на бронювання, розірвіть з'єднання до відповіді й надішліть його знову. Тепер у вас один PNR чи два? Цей один тест розповість про постачальника більше, ніж решта тестового періоду разом.
- Бронювання створено, виписка не вдалася. Чи може API повідомити про PNR, який існує, але не виписаний, і чи називає він дедлайн виписки?
- Частковий збій. Запит на кілька номерів у готелі, де один підтверджується, а інший ні. Переліт туди й назад, де ділянки прийшли з різних джерел.
- Скасування поза безкоштовним вікном. Штраф називають до підтвердження чи ви дізнаєтеся про нього з рахунку?
- Збій постачальника. Запитайте постачальника, як його змоделювати. Якщо він не знає, запитайте, як його клієнти дізналися, як система тоді поводиться.
У кожному випадку ви оцінюєте дві речі. Перше: чи каже API правду про стан бронювання? Друге: чи може ваш код діяти на основі цієї правди без людини, що читає вільний текст? З API, який падає зрозуміло, жити легше, ніж з тим, що спрацьовує неоднозначно.
Про авіа-частину ми писали докладніше в тексті про те, чого не пишуть у документації API бронювання авіаквитків, а про проєктування клієнта для повільних готельних постачальників — у матеріалі про наявність готелів. Обидва добре доповнюють план тестового періоду.
Питання, що викривають тонкого агрегатора
В агрегаторі немає нічого поганого. Більшість туристичного контенту доходить до більшості продавців саме через когось із них. Ризик — у тонкому агрегаторі: шарі, що перепродує API іншого шару, додає маржу і не володіє ні договором із постачальником, ні власним операційним відділом. Коли щось ламається, відповідь має пройти дві компанії вгору і назад.
П'ять питань швидко це виявляють:
- Хто постачальник за договором для цього бронювання? На чиєму договорі з авіакомпанією чи готелем воно тримається?
- Через чий номер IATA і чий BSP проходить квиток? Якщо відповідь «партнера», запитайте, хто отримує ADM, коли порушено тарифне правило.
- Що відбувається у вас, коли я викликаю cancel? Автоматичний виклик до постачальника чи черга, яку розбирає людина?
- Чи можу я побачити вихідну помилку? Тонкий шар зазвичай сплющує будь-який збій до одного коду, бо не до кінця розуміє помилки, які отримує.
- Кому я дзвоню щодо завислого живого бронювання, і кому дзвонять вони? Порахуйте ланки.
Жодна з цих відповідей сама собою не дискваліфікує. Номер IATA партнера може бути нормальним, якщо в договорі чітко сказано, хто несе дебет-ноту. Важливо, щоб постачальник відповідав точно і швидко. Розмиті відповіді сьогодні — це ті, які ви отримаєте пізніше, у продакшні, у гірший час.
Скільки коштує помилка у виборі
Інтеграція — дешева частина. Дорогі приходять пізніше і не потрапляють у жоден кошторис.
Баг із подвійним бронюванням — це клієнт, з якого списали двічі, і PNR, який треба знайти й скасувати вручну, можливо, вже після закриття безкоштовного вікна void. Бронювання, яке пройшло в джерелі, коли ваша сторона записала збій, — це утримане місце, потім автоматичне скасування і клієнт, певний, що в нього є бронь. Перевізник, якого показали, але не змогли виписати, — це повернення коштів, вибачення і клієнт, який не повернеться. ADM за тарифне правило, порушене маршрутом постачальника, надходить власникові квитка — переконайтеся заздалегідь, чи це ви.
А ще є вартість переходу. Кожне дивацтво постачальника, яке ви поглинаєте, — код статусу з двома значеннями, поле, що іноді буває рядком, — опиняється у вашій моделі даних. Через два роки вибір API — це вже не інтеграція, яку можна замінити за спринт; це форма вашої таблиці бронювань. Ось справжня причина порівнювати уважно зараз.
Як наш API вписується в цю схему
Ми надаємо API для авіаквитків і готелів. Доступ починається з розмови, а не з ключа в режимі self-service, і деяким розробникам це здається повільним; причина в тому, що саме в цій розмові питання вище ставляться в обидва боки — які маршрути й міста вам потрібні, який контент ви реально зможете виписати чи підтвердити і хто що робить після бронювання. Якщо ви проводите порівняння, візьміть цей список із собою. Сторінка про travel API — місце, де ця розмова починається.
Хоч що ви оберете, обирайте за журналом тестового періоду, а не за презентацією. Презентація каже, ким постачальник хоче бути. Шляхи помилок кажуть, ким він є.