API за цени на полети: защо показаната цифра още не е тарифа

Демото работи. Разработчик свързва API за цени на полети към календар на най-евтините дни за пътуване, мрежата се изпълва с числа и всички в стаята са доволни. После първият истински клиент избира дата, вижда на страницата с резултати по-ниска сума, отколкото на страницата за плащане, и пише на поддръжката със снимка на екрана. Нищо не е счупено. API-то е направило точно това, което му е поискано: отговорило е на въпрос за цена, а сайтът е приел отговора за обещание.
Цената е оферта с къса памет
Самолетната тарифа не е фиксиран етикет върху седалката. Тя е резервационен клас, който се отваря и затваря с продажбата на места, а числото към нея се променя със състава на пътниците, с точните полети, с таксите на засегнатите летища и с валутата, в която е изразена офертата. Отговорът с цена е моментна снимка, направена в един момент за един набор от входни данни. Третирате ли го като факт за миналото, ще изградите правилното нещо; третирате ли го като факт за настоящето, ще прекарате месец във възстановявания на суми.
Полезният въпрос за разработчика никога не е само каква е цената. А какъв вид цена е това, колко е стара и какво ще направи системата, ако се окаже грешна.
Три числа, които всички наричат цена
Повечето доставчици връщат и трите някъде в документацията си, често под едно и също име на поле. Дръжте ги разделени в собствения си модел на данни от първия ден.
| Състояние | Откъде идва | Колко е прясна | Може ли да се продаде? | Какво да се покаже |
|---|---|---|---|---|
| Цена при търсене | Кеширано или агрегирано търсене, направено за скорост и обхват | Възможно е да е остаряла и да не е изчислена за вашите пътници | Не | Формулировка „от“ и бележка, че може да се промени |
| Оценена оферта | Заявка на живо за точния маршрут, типовете пътници и тарифата | Прясна в момента на повикването, с изтичане или сигнал за преоценка | Да, докато не изтече | Общата сума, изброените такси, правилата на тарифата |
| Издадена сума | Каквото авиокомпанията или издаващата система реално е начислила при поръчката | Окончателна | Вече продадено | Разписката; сверете я с офертата |
Цената при търсене прави възможни календарите и значките „най-евтино от“ и е добре да се изгради. Просто не е същият обект като втория ред. Грешката е едно-единствено поле, наречено price, в което се вливат и трите.
На практика това означава три отделни типа или таблици в кода, а не един с флаг. Цената при търсене може да е грешна в дребното, защото е само подкана да се кликне. Оценената оферта е ангажимент, който ще поемете със собственото си име, затова се съхранява с часа на получаване, с входните данни, които са я породили, и с идентификатора, който доставчикът ще поиска обратно при поръчката. Издадената сума е счетоводство. Когато поддръжката пита защо клиент е платил различно число от това в имейла, отговорът е в разликата между редовете и можете да я прочетете само ако сте запазили и трите.
Какво трябва да носи отговорът с цена
Голото число не стига за изграждане на каса. Когато четете примерния отговор на доставчика, търсете следното и бъдете подозрителни към всичко, което идва като свободен текст.
- Валутата, посочена в отговора, а не предположена от вашия акаунт.
- Базова тарифа и такси поотделно, за да покажете разбивка и промяна в таксите да не изглежда като промяна на тарифата.
- Типовете пътници, за които е изчислена цената. Цената за възрастен по три не е семейна тарифа.
- Правилата на тарифата и багажът като структурирани данни, защото те решават дали евтината опция е наистина по-евтина за клиента.
- Сигнал за изтичане или преоценка: времеви печат или изрично твърдение, че трябва да преоцените преди поръчката.
Последната точка хората пропускат. Ако нищо в отговора не казва колко живее офертата, гадаете, а гаденето става в продукция.
Преоценявайте преди поръчката, не след нея
Най-сигурният ритъм има правило в себе си. Търсете, за да разглеждате. Когато клиентът избере маршрут, искате оферта, оценена на живо за точно този маршрут и тези пътници. Показвате на клиента тази обща сума. Едва тогава създавате поръчката. Ако цената на живо се различава от тази на страницата с резултати, казвате на клиента преди плащането, с прости думи, а не след него.
Пропуснете ли средната стъпка, наследявате разликата. Или начислявате повече, отколкото клиентът е видял, и губите продажбата на страницата за плащане, или спазвате по-ниското число и пролуката излиза от вашата марж. Малка агенция може да погълне това няколко пъти; не може да го погълне като дизайн.
Питайте това писмено, преди да интегрирате
Документацията описва щастливия път. Поведението, което струва пари, е в отговорите на кратък списък от въпроси и си струва да ги имате в имейл, а не в разговор.
- Цената в отговора на търсенето на живо ли е, или е кеширана, и пише ли това в самия отговор?
- Има ли отделно повикване за оценка на точния маршрут и задължително ли е преди поръчка?
- Какво става при поръчка, ако цената се е променила: отказ, нова цена в отговора или тиха емисия на новата сума?
- Как са изброени таксите и горивните надбавки и могат ли да се променят между оценката и издаването?
- В каква валута се изчислява цената и къде става конверсията, ако клиентът види друга?
- Колко време е валидна оценената оферта и как ще разберете?
Доставчик, който отговаря точно на тези въпроси, е мислил за касата. Този, който казва „винаги е актуално“, не ви е казал нищо, което можете да тествате. Ако не можете сами да изпробвате поведението, това е причина да погледнете по друг начин на цялото решение, преди да се ангажирате да градите около него.
Колко струва грешката
Рядко се проваля шумно. Проваля се като малък спад на стъпката за плащане, който никой не приписва на цената, като заявки към поддръжката, започващи с „цената се промени“, като клиент, който се е доверил на страницата с резултати, а сега вече не. Служителите накрая потвърждават тарифите на ръка преди издаване. Някой предлага правило, което за всеки случай закръгля цените нагоре, и сайтът става скъп точно на екрана, където хората сравняват. Всичко това е данък върху решение, което в началото е било евтино да се вземе правилно.
Къде стои тази платформа
Платформата предлага API за полети и хотели, активирани за всеки тенант. Достъпът започва като разговор, а не като ключ за самообслужване, така че няма форма за регистрация, която да ви даде токен и таблица с лимити. Тази страница не публикува латентност, покритие или брой тарифи, защото число, чието тестване не можем да ви покажем, не си заслужава да бъде отпечатано. Можете да занесете горните въпроси на този разговор и да поискате да видите отговора за оценена оферта, не само за търсене. Ако сте на този етап, страницата за API за пътувания е мястото, откъдето започва.