Preskočiť na obsah
Blog

Integrácia API na rezerváciu leteniek: čo v dokumentácii nenájdete

Redakcia Tekravel
Napísané s pomocou AI

Úloha na tabuli znie „pridať lety“. Máte za sebou integráciu platobnej brány, výpočet poštovného, možno mapy, a prinášate si najjednoduchší model: vyhľadať, zobraziť výsledky, strhnúť kartu, hotovo. Potom sa prvá skutočná rezervácia vráti s inou cenou, než bola vo výsledkoch, druhá skončí timeoutom a nikto vám nevie povedať, či má zákazník miesto, a niekto z prevádzky sa pýta, prečo existuje rezervácia, ale žiadna letenka. Integrácia API na rezerváciu leteniek zvonka pripomína pokladňu e-shopu. Pod povrchom je to distribuovaná transakcia voči systémom, ktoré vznikli dávno pred REST-om, a väčšina prekvapení pochádza práve z tohto rozdielu.

Text je pre vývojára, ktorý ešte nikdy nevidel PNR. Nejde o endpointy konkrétneho dodávateľa; názvy sa medzi poskytovateľmi menia, tvar zostáva rovnaký.

Poradie volaní pri integrácii API na rezerváciu leteniek

Takmer každé letecké API, nech svoje metódy volá akokoľvek, prechádza tými istými štyrmi krokmi. Správne nastaviť hranice medzi nimi je väčšina práce.

KrokČo dostaneteČo musíte uložiťČo sa pokazí
VyhľadanieItineráre s cenou a nepriehľadným kľúčom ponuky alebo tarifyNič trvalé — výsledky rýchlo zastarávajúCenu berete ako konečnú; kľúč vyprší pred platbou
Overenie cenyPotvrdená cena, tarifné pravidlá, batožina, niekedy povinné údaje o cestujúcichOverenú ponuku a čas jej platnostiCena sa zmenila; trieda sa vypredala; pravidlá sa líšia od zobrazených
RezerváciaRezervácia — PNR — s kódom rezervácie a termínom na vystavenie letenkyVlastnú referenciu, kód, termín a presne odoslané údaje cestujúcichTimeout bez odpovede; duplicitné PNR; odmietnuté mená
Vystavenie letenkyČísla e-leteniek; tu sa peniaze skutočne zaväzujúKaždé číslo letenky priradené k cestujúcemu a segmentuČiastočné vystavenie; letecká spoločnosť zrušila rezerváciu po uplynutí termínu

Ľudia sa hádajú hlavne o treťom riadku, pretože mnohé API dovolia rezervovať a vystaviť letenku jedným volaním. Pokojne ho použite. Vo svete leteckých spoločností sú to však stále dve veci: PNR môže existovať bez letenky a vystavenie môže zlyhať, keď PNR už vzniklo. Kombinovaný endpoint len skryje okamih, keď jedno uspelo a druhé nie, takže váš dátový model by mal mať pre tento stav miesto.

Všimnite si aj, čo vyhľadávanie nevracia: sľub. Je to reklama. Overenie ceny je ponuka a predajom je až letenka.

Prečo nájdená cena nie je cena, za ktorú rezervujete

Webový vývojár čaká katalóg. Letecký inventár ním nie je. Let sa predáva v rezervačných triedach, každá je vedro miest za určitú tarifu, a letecká spoločnosť tieto vedrá priebežne otvára a zatvára podľa toho, ako sa lietadlo plní. Výsledky vyhľadávania sa skladajú rýchlo z dostupnosti, ktorá už môže trochu zaostávať; kým používateľ prepíše dva pasy, najlacnejšia trieda na lete sa mohla zavrieť. Krok overenia sa pýta znova a poctivá odpoveď je niekedy vyššia.

Dane pridávajú vlastný posun. Prepočítavajú sa pri overení pre presných cestujúcich a trasu, a dieťa či batoľa má inú cenu než dospelý, ktorého predpokladalo vyhľadávanie. Ak váš obchod zobrazuje inú menu, než v akej dodávateľ kótuje, prepočet meny je ďalšie miesto, kde sa číslo hýbe.

Dôsledok pre návrh je jednoduchý a často vynechaný: nikdy nestrhávajte platbu podľa ceny z vyhľadávania. Pred platbou spustite overenie, porovnajte a ak sa suma zmenila, ukážte novú a opýtajte sa. Prirážku treba prepočítať z novej ceny, nie preniesť z výsledkov — logika je rovnaká, akou prechádza kancelária pri nastavovaní stratégie prirážky online, a láme sa rovnako, keď sa základ pod ňou pohne.

Idempotencia a čo znamená timeout počas rezervácie

Túto časť si prečítajte dvakrát.

Keď rezervačné volanie skončí timeoutom, neviete, čo sa stalo. Požiadavka možno vôbec nedorazila. Možno dorazila a zlyhala. Alebo — prípad, ktorý bolí — dorazila, dodávateľ u leteckej spoločnosti vytvoril PNR a odpoveď sa stratila na ceste späť. Pre váš kód vyzerajú všetky tri rovnako. Pre leteckú spoločnosť je tretí živá rezervácia, ktorá drží miesta na meno vášho zákazníka.

Reflex z iných integrácií je zopakovať volanie. Tu môže slepé opakovanie vytvoriť druhé PNR pre tých istých cestujúcich na ten istý let. Letecké spoločnosti považujú duplicitné rezervácie za porušenie pravidiel; podľa dopravcu a zmlúv kancelárie sa následok pohybuje od automatického zrušenia jednej či oboch rezervácií až po debetné oznámenie — ADM — tomu, kto ich vystavil. Kancelária, ktorá ho dostane, sa bude chcieť dozvedieť, prečo váš systém rezervoval dvakrát.

Čo funguje, zhruba v tomto poradí:

  • Vytvorte si vlastnú referenciu rezervácie ešte pred volaním, uložte ju a posielajte s požiadavkou všade, kde API prijíma klientsku referenciu. Ak API podporuje idempotentný kľúč, použite ho; ak nie, vaša referencia je stále to, podľa čoho rezerváciu neskôr nájdete.
  • Neznámy stav modelujte výslovne. Čaká, potvrdená, zlyhala — a neznáma. Timeout presúva rezerváciu do stavu neznáma, nie zlyhala.
  • Neznámy stav riešte otázkou, nie opakovaním. Skôr než sa rozhodnete skúsiť znova, načítajte rezerváciu podľa svojej referencie alebo si vypýtajte nedávne rezervácie týchto cestujúcich.
  • Spustite zosúladzovaciu úlohu, ktorá prejde všetko, čo zostalo neznáme, porovná to s tým, čo hlási dodávateľ, a čo nevie uzavrieť, pošle do fronty pre človeka namiesto hádania.

Timeouty pri vystavovaní leteniek sú ten istý problém, len s peniazmi. Ak strhnete platbu pred vystavením a vystavenie zamrzne, máte zaplateného zákazníka a možno žiadnu letenku. Ak vystavíte pred strhnutím a strhnutie zlyhá, vydali ste dokument, ktorý niekto musí leteckej spoločnosti zaplatiť. Bežný postup je kartu najprv autorizovať, potom vystaviť letenku a pri úspechu sumu strhnúť — podstatné je rozhodnúť to vedome, nie to objaviť v produkcii.

Letecké pojmy, ktoré webového vývojára prekvapia

Žiadny z nich nie je ťažký. Každý už niekoho stál týždeň, lebo nevedel, že existuje.

PNR nie je letenka

PNR je záznam rezervácie: cestujúci, segmenty, kontakty, termín. Letenka je zaplatený dokument, ktorý cestujúceho oprávňuje letieť. PNR bez letenky v termíne vyprší a miesta sa vrátia do predaja, z vášho pohľadu niekedy potichu.

Mená sa takmer nedajú zmeniť

Po vystavení väčšina taríf nepovolí zmenu mena nad rámec drobnej opravy a čo sa považuje za drobné, určuje každá letecká spoločnosť inak. Meno musí zodpovedať cestovnému dokladu. Priezvisko a krstné mená zbierajte oddelene, nedovoľte, aby sa titul z voľného textu dostal do poľa mena, a validujte pred rezervačným volaním, nie po ňom.

Typy cestujúcich majú cenu, nie sú ozdobou

Dospelý, dieťa a batoľa sú tarifné typy a vek, ktorý rozhoduje, je zvyčajne vek v deň cesty, nie v deň rezervácie. Batoľa na kolenách väčšinou nezaberá miesto a smie cestovať len s dospelým. Pomýlite typ a overenie ceny buď zlyhá, alebo ponúkne nesprávnu tarifu.

Časy sú miestne a segmenty nie sú úseky

Časy odletu a príletu sú v miestnom čase každého letiska. Neprevádzajte ich na zobrazenie do časového pásma používateľa a nepočítajte trvanie odčítaním bez posunov. Cesta obsahuje segmenty; segment s technickým medzipristátím obsahuje viac než jeden úsek. Vaše rozhranie a vaše dáta sa musia zhodnúť, čo z toho je „prestup“.

Veci sa dejú aj po predaji

Letecké spoločnosti menia letové poriadky aj po vystavení leteniek. Rezervácia, ktorá bola pri vystavení správna, môže o týždne neskôr ukazovať nový čas, nové číslo letu alebo prerušený prestup, a podľa dodávateľa sa to dozviete z notifikácie, z fronty alebo opätovným načítaním rezervácie. Počítajte s tým, že sa rezervácia zmení, keď sa na ňu už nepozeráte.

Void nie je refundácia

Krátko po vystavení zvyčajne existuje okno, v ktorom sa letenka dá stornovať (void), akoby nikdy neexistovala. Po ňom je možná len refundácia podľa tarifných pravidiel, ktorá môže stáť poplatok alebo nevrátiť nič. Okno a jeho pravidlá patria dodávateľovi a zmluve o vystavovaní; prečítajte si ich skôr, než postavíte tlačidlo „zrušiť“.

Čo stojí chyba

Zlyhania v leteckej integrácii sú drahé špecifickým spôsobom: dopadnú na ľudí, nie do logov. Duplicitná rezervácia znamená telefonát leteckej spoločnosti a možno oznámenie voči účtu kancelárie. Zaplatený zákazník bez letenky znamená refundáciu, sťažnosť a riziko chargebacku. Letenka vystavená bez úspešnej platby je dlh voči leteckej spoločnosti, ktorý niekto musí vyrovnať. Zmena letového poriadku, ktorú nikto nespracoval, je cestujúci na letisku pri lete, ktorý odletel skôr.

Nič z toho sa v teste šťastnej cesty neukáže. Najprv napíšte nešťastné cesty: timeout počas rezervácie, cenu, ktorá stúpla, letenku, ktorá zlyhala po vzniku PNR, void po úspešnej platbe. Ak sú tieto vyriešené, šťastná cesta je tá ľahšia časť.

Testovanie voči leteckému API

Testovacie prostredia dodávateľov sú užitočné a neúplné. Bývajú tichšie než produkcia, takže vypredané triedy a zmeny cien sú zriedkavejšie, a niektoré timeouty vôbec nesimulujú. Použite ich na tvar volaní a validačné chyby, potom naplánujte kontrolovaný beh v produkcii so skutočnými rezerváciami, ktoré v okne stornujete — a s prevádzkou, ktorá o tom vie.

Či vôbec integrovať, je samostatná otázka. Ak v skutočnosti potrebujete obchod, nie surový inventár vo vlastnom systéme, kompromis je rozobratý v článku white label alebo vlastný rezervačný systém a rovnaká úvaha platí pre B2B portál pre subagentov. Ak inventár vo vlastnom kóde chcete, táto platforma ponúka API pre lety a hotely a prístup začína rozhovorom o vašom použití, nie samoobslužným kľúčom — čo je zároveň správna chvíľa položiť každú z otázok vyššie.

Redakcia Tekravel

Rubrika cestovných technológií

Rubrika cestovných technológií Tekravel píše pre odvetvie: majiteľov agentúr, konsolidátorov a vývojárov, ktorí ich integrujú. Každý článok je pred vydaním overený na platforme, ktorú opisuje.