API цін на авіаквитки: чому ця цифра ще не тариф

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