Pređi na sadržaj
Blog

Интеграција API-ја за резервацију летова: шта документација прећуткује

Редакција Tekravel
Napisano uz pomoć veštačke inteligencije

На картици на табли пише „додај летове". Већ сте испоручили интеграцију плаћања, интеграцију цена доставе, можда и мапа, а ментални модел који доносите је онај очигледан: претражи, прикажи резултате, наплати картицу, готово. Онда се прва права резервација врати по другачијој цени од оне на страници са резултатима, друга падне у timeout и нико не може да вам каже да ли клијент има седиште, а неко из оперативе пита зашто постоји резервација, али не и карта. Интеграција API-ја за резервацију летова споља изгледа као checkout интернет продавнице. Испод је дистрибуирана трансакција према системима пројектованим много пре REST-а, и већина изненађења долази управо из тог процепа.

Текст је написан за програмера који никада није видео PNR. Не бави се endpoint-има једног конкретног добављача; имена се мењају од провајдера до провајдера, облик не.

Низ позива иза интеграције API-ја за резервацију летова

Готово сваки API за летове, како год звао своје методе, пролази кроз иста четири корака. Правилно повлачење граница између њих је највећи део посла.

КоракШта вам дајеШта морате сачуватиШта пође наопако
ПретрагаИтинерере са ценом и непрозирним кључем понуде или тарифеНишта трајно — резултати брзо застаревајуТретирате цену као коначну; кључ истиче пре checkout-а
Обрачун / провераПотврђену цену, тарифна правила, пртљаг, понекад обавезна поља путникаПроверену понуду и њен рокЦена се променила; класа је распродата; правила се разликују од приказаних
РезервацијаРезервацију — PNR — са record locator-ом и роком за издавањеСопствену референцу, locator, рок, тачне податке путника које сте послалиTimeout без одговора; дупли PNR-ови; одбијена имена
ИздавањеИздате бројеве е-карата; овде се новац заиста ангажујеСваки број карте, везан за путника и сегмент којима припадаДелимично издавање; авио-компанија отказала резервацију јер је рок истекао

Ред око којег се људи споре је трећи, јер многи API-ји дозвољавају резервацију и издавање у једном позиву. Користите га ако желите. Те две ствари и даље су раздвојене у свету авио-компаније: PNR може постојати без карте, а издавање може пропасти након што је PNR креиран. Комбиновани endpoint само скрива тренутак у којем је једно успело, а друго није, па ваш модел података ипак мора имати место за то стање.

Приметите и шта претрага не враћа: обећање. Она је оглас. Корак обрачуна је понуда, а тек карта је продаја.

Зашто цена коју сте претражили није цена коју резервишете

Веб програмери очекују каталог. Инвентар авио-компанија то није. Лет се продаје у класама резервације, свака је кофа седишта по одређеној тарифи, а авио-компанија непрекидно отвара и затвара те кофе како се лет пуни. Резултати претраге се брзо састављају из расположивости која можда већ мало касни; док корисник укуца два пасоша, најјефтинија кофа на том лету може да се затвори. Када се покрене корак обрачуна, он пита поново, а искрен одговор је понекад виши.

Таксе додају сопствено одступање. Поново се рачунају при обрачуну за тачне путнике и руту, а дете или беба обрачунавају се другачије од одрасле особе коју је претрага претпоставила. Конверзија валуте, ако ваша продавница приказује динаре или евре, а добављач котира у другој валути, још је једно место где се број помера.

Последица по дизајн је једноставна и често се прескаче: никада не наплаћујте по цени из претраге. Покрените корак обрачуна пре плаћања, упоредите, и ако се износ променио, прикажите нови број и питајте. Коју год маржу примењујете, мора се поново израчунати на обрачунатој тарифи, а не пренети са странице са резултатима — логика је иста као она коју агенција пролази када поставља стратегију марже онлајн, и ломи се на исти начин када се основа помери испод ње.

Идемпотентност и шта значи timeout током резервације

Ово је одељак који треба прочитати два пута.

Када позив за резервацију падне у timeout, не знате шта се догодило. Захтев можда никада није стигао. Можда је стигао и пропао. Или — случај који боли — стигао је, добављач је креирао PNR код авио-компаније, а одговор се изгубио на путу назад до вас. За ваш код сва три изгледају идентично. За авио-компанију, трећи је жива резервација која држи седишта на име вашег клијента.

Рефлекс из других интеграција је да покушате поново. Овде слепо понављање може да произведе други PNR за исте путнике на истом лету. Авио-компаније третирају дупле резервације као кршење политике; у зависности од превозника и уговора агенције, последица иде од аутоматског отказивања једне или обе резервације до задужења — ADM-а — послатог ономе ко их је издао. Агенција која га прими желеће да зна зашто је ваш систем резервисао два пута.

Шта функционише, отприлике овим редом:

  • Креирајте сопствену референцу резервације пре позива напоље, сачувајте је и пошаљите уз захтев свуда где API прихвата клијентску референцу. Ако API подржава idempotency key, користите га; ако не, ваша референца је и даље оно што вам омогућава да резервацију касније пронађете.
  • Експлицитно моделујте непознато стање. На чекању, потврђено, неуспешно — и непознато. Timeout пребацује резервацију у непознато, не у неуспешно.
  • Непознато разрешавајте питањем, не понављањем. Преузмите по својој референци или излистајте недавне резервације за те путнике пре него што одлучите да ли да покушате поново.
  • Покрените посао усаглашавања који прелази све што је још непознато, пореди са оним што добављач пријављује и оно што не може да реши шаље у ред за човека уместо да нагађа.

Timeout при издавању је исти проблем, само са новцем. Ако наплатите картицу пре издавања, а издавање заглави, имате клијента који је платио и можда нема карту. Ако издате пре наплате, а наплата пропадне, издали сте документ који неко мора да плати авио-компанији. Прво ауторизација картице, затим издавање, па наплата при успеху уобичајен је облик — поента је да то одлучите свесно, а не да откријете у продукцији.

Појмови из туристичке струке који изненаде веб програмере

Ниједан од њих није тежак. Сваки је некога коштао недељу дана јер није знао да постоји.

PNR није карта

PNR је запис резервације: путници, сегменти, контакти, рок. Карта је плаћени документ који путнику даје право да лети. Неиздат PNR истиче на свој рок за издавање и седишта се враћају у продају, понекад нечујно из вашег угла.

Имена су готово непроменљива

Након издавања већина тарифа не дозвољава промену имена изван ситне исправке, а шта се рачуна као ситно разликује се по авио-компанији. Име мора да одговара путној исправи. Прикупљајте презиме и имена одвојено, не дозволите да слободно унета титула процури у поље за име и валидирајте пре позива за резервацију, не после.

Типови путника се обрачунавају, нису декорација

Одрасли, дете и беба су тарифни типови, а старост која одлучује који важи обично је старост на дан путовања, а не на дан резервације. Беба у крилу по правилу не заузима седиште и често може да путује само уз одраслу особу. Погрешан тип значи да обрачун или пропадне или понуди погрешну тарифу.

Времена су локална, а сегменти нису етапе

Времена полетања и слетања дају се у локалном времену сваког аеродрома. Не претварајте их у корисникову временску зону ради приказа и не рачунајте трајање одузимањем без помака. Путовање садржи сегменте; сегмент са техничким слетањем садржи више од једне етапе. Ваш интерфејс и ваши подаци морају се сложити шта је од тога „стајање".

Ствари се дешавају и после продаје

Авио-компаније мењају редове летења након што су карте издате. Резервација која је била исправна при издавању може недељама касније да показује ново време, нови број лета или прекинуту везу, а у зависности од добављача сазнајете то кроз обавештење, ред или поновним преузимањем резервације. Планирајте да ће се резервација променити након што сте престали да је гледате.

Void није повраћај

Убрзо након издавања обично постоји прозор у којем се карта може поништити (void) као да никада није постојала. После тог прозора могућ је само повраћај по тарифним правилима, који може коштати пенал или не вратити ништа. Прозор и његова правила припадају добављачу и уговору о издавању; прочитајте их пре него што направите дугме „откажи".

Колико кошта грешка

Неуспеси у интеграцији летова скупи су на специфичан начин: падају на људе, не у логове. Дупла резервација постаје телефонски позив авио-компанији и могуће задужење на рачуну агенције. Наплаћени клијент без карте постаје повраћај, жалба и ризик од chargeback-а. Карта издата без успешне наплате постаје дуг према авио-компанији који неко мора да измири. Промена реда летења коју нико није обрадио постаје путник на аеродрому за лет који је отишао раније.

Ништа од тога се не појављује у тесту срећног пута. Прво напишите несрећне путеве: timeout током резервације, цену која је порасла, издавање које је пропало после PNR-а, void после успешне наплате. Ако су они обрађени, срећан пут је лакши део.

Тестирање према API-ју за летове

Тест окружења добављача су корисна и непотпуна. Обично су мирнија од продукције, па су распродате класе и промене цена ређе, а нека уопште не симулирају timeout. Користите их за облик позива и грешке валидације, а затим планирајте контролисано извршавање у продукцији са правим резервацијама које поништавате унутар прозора — уз оперативу која зна да то радите.

Да ли уопште интегрисати је засебно питање. Ако вам заправо треба продајни сајт, а не сирови инвентар у сопственом систему, компромис је описан у тексту white label или сопствени систем резервација, а исто резоновање важи и за B2B портал за субагенте. Ако заиста желите инвентар у сопственом коду, платформа излаже API-је за летове и хотеле, а приступ почиње разговором о вашем случају употребе, а не самоуслужним кључем — што је уједно и прави тренутак да поставите свако од горњих питања.

Редакција Tekravel

Деск за путничке технологије

Деск за путничке технологије Tekravel-а пише за струку: власнике агенција, консолидаторе и програмере који их интегришу. Сваки чланак се пре објаве проверава на платформи коју описује.