Preskočiť na obsah
Blog

Porovnanie travel API: hodnoťte osi, nie dodávateľov

Redakcia Tekravel
Napísané s pomocou AI

Máte otvorené tri prezentácie od troch dodávateľov v troch záložkách. V každej je slajd s dlhým zoznamom aerolínií, slajd s počtom hotelov, sandbox, REST a JSON a e-mail na podporu. Postavíte tabuľku, do každej bunky dáte fajku a tabuľka skončí remízou. Takto sa zvyčajne končí porovnanie travel API robené ako kontrolný zoznam funkcií — a je to zlý koniec, pretože rozdiely, ktoré rozhodnú o vašom ďalšom roku, sa ukážu až po spustení: pri rezervácii, ktorá u dodávateľa prešla, no na vašej strane vypršal časový limit; pri refundácii, ktorú nikto nevie spracovať; pri aerolínii, ktorá v zozname bola, ale touto cestou sa na ňu letenka vystaviť nedá.

Tento text je pre vývojára alebo technického lídra, ktorý musí toto rozhodnutie urobiť a neskôr ho obhájiť. Dodávateľov neradí do poradia. Dáva vám osi na porovnanie, plán skúšobnej verzie, ktorý trávi čas na chybách, a krátku sadu otázok, z ktorých rýchlo zistíte, či hovoríte s dodávateľom, alebo s predajcom cudzieho dodávateľa.

Prečo kontrolný zoznam funkcií vždy skončí remízou

Kontrolný zoznam sa pýta, či schopnosť existuje. Takmer každé travel API vie odpovedať áno takmer na každý riadok, lebo riadky sú napísané na úrovni marketingovej stránky: vyhľadávanie, cena, rezervácia, storno, vystavenie letenky, webhooky, sandbox. Otázka, ktorá ich od seba oddelí, nie je, či cancel existuje, ale čo sa stane, keď ho zavoláte na vystavenú rezerváciu dvanásť hodín pred odletom, na tarifu s pokutou, cez cestu, kde obsah prišiel od tretej strany. Na to v zozname stĺpec nie je.

Je tu aj druhý problém. Zoznam zvyčajne vypĺňa samotný dodávateľ. Hodnotíte jeho vlastný popis.

Porovnanie travel API postavené na osiach, nie na dodávateľoch

Mriežku „dodávateľ krát funkcia“ nahraďte osami, ktoré hodnotíte sami, na základe dôkazov zo skúšobnej verzie. Tabuľka nižšie je tá, ktorú by sme použili my. Riadky si môžete vážiť inak — firma, ktorá predáva iba hotely, rieši vystavovanie leteniek menej — a mali by ste sa s ňou pohádať skôr, než ju prevezmete.

OsČo sa pýta kontrolný zoznamČo naozaj zistiťAko znie slabá odpoveď
PokrytieKoľko aerolínií a hotelov?Koľko z nich sa dá cez toto API vyhľadať, zarezervovať A vystaviť či potvrdiť — na vašich trhochJedno veľké číslo bez rozpisu
HĺbkaExistuje endpoint na storno?Ktoré úkony po rezervácii sú automatizované pre každý zdroj obsahu: void, refundácia, reissue, oprava mena, doplnkové služby„To rieši náš operačný tím“
Integrita cenyJe cena v reálnom čase?Ako často sa cena pri rezervácii líši od ceny pri vyhľadávaní a ako vám to API oznámi„Ceny sú vždy živé“
Sémantika chýbSú chyby zdokumentované?Či chyba povie, v akom stave je rezervácia, nielen že niečo zlyhaloJeden všeobecný kód pre každé zlyhanie
Idempotencia—Či opakované volanie rezervácie môže vytvoriť druhú rezerváciuTicho, potom „s tým sme sa nestretli“
Dodávateľ záznamu—Čia zmluva, čie číslo IATA, cez čí BSP ide letenka„Pracujeme so všetkými veľkými GDS“
Prístup a podporaJe k dispozícii sandbox?Kto odpovie, keď sa zasekne živý PNR, a ako rýchloFormulár na tiket a žiadny konkrétny kontakt

Dva z týchto riadkov nemajú v kontrolnom zozname žiadnu otázku. Nie je to náhoda: sú to riadky, ktoré stoja najviac, keď sa pokazia, a ktoré prezentácia dodávateľa ponúkne sama od seba najmenej ochotne.

Pokrytie nie je hĺbka

Zoznam aerolínií je najzavádzajúcejší slajd v každej prezentácii. Zoznam niekoľkých stoviek dopravcov môže znamenať niekoľko rôznych vecí a iba jedna z nich je to, čo chcete.

Niektoré z týchto dopravcov idú cez GDS a dajú sa zarezervovať aj vystaviť od začiatku do konca. Niektoré idú cez pripojenia NDC, kde vyhľadávanie môže fungovať dobre, no servis po rezervácii — zmeny, čiastočné refundácie, pridanie batožiny — môže byť pre danú aerolíniu stále ručný. Niektoré sú nízkonákladové spoločnosti, ktorých obsah je agregovaný od iného predajcu; zobraziť ich viete, niekedy ich viete aj zarezervovať, a potom letenka príde cestou, ktorú nekontrolujete, v čase, ktorý zákazníkovi nemôžete sľúbiť. A niektoré sú v zozname preto, že sa raz vo výsledku vyhľadávania objavila tarifa.

Dopravca, ktorého viete ukázať, ale nie vystaviť, nie je pokrytie. Pre retailový produkt je to horšie než jeho absencia, pretože zákazník si ho vyberie, zaplatí a potom čaká.

Hotely majú ten istý tvar, len iné slová. Počet ubytovaní zahŕňa objekty, ktoré dodávateľ namapoval, aj tie, ktoré nenamapoval; statické ceny uložené minulý týždeň vedľa živej dostupnosti; izby na allotmente s release obdobím vedľa free-sale inventára. Pýtajte sa na počet, ktorý je naživo rezervovateľný v mestách, kde predávate, a pýtajte sa, ako sa spájajú duplicity naprieč ich vlastnými dodávateľmi — ten istý hotel trikrát za tri ceny je tiket na podporu, ktorý len čaká, kedy príde.

Praktický test je úzky. Napíšte si dvadsať trás a dvadsať hotelových miest, ktoré tvoria väčšinu vášho objemu, a požiadajte dodávateľa, aby práve tie ukázal v sandboxe od začiatku do konca: vyhľadanie, cena, rezervácia, vystavenie či potvrdenie, storno. Dodávateľ, ktorý tú hĺbku má, to urobí bez ťahaníc. Dodávateľ, ktorý má len slajd, začne rozprávať o slajde.

Čo testovať v skúšobnej verzii: chybové cesty, nie šťastné

Každý sandbox úspešne zarezervuje jednosmernú ekonomickú letenku na tichej trase. Presne na to bol postavený. Vaša produkčná prevádzka strávi podstatnú časť života na tých ostatných cestách a skúšobná verzia je jediný lacný moment, kedy ich uvidíte.

V skúšobnej verzii prejdite tento zoznam a zapisujte si, čo API vrátilo, vedľa toho, čo bola potom pravda:

  • Zmena ceny medzi vyhľadaním a rezerváciou. Zlyhá volanie rezervácie, prejde za novú cenu, alebo vráti samostatnú odpoveď, ktorá žiada potvrdenie? Vie to vaše UI rozlíšiť bez parsovania textu správy?
  • Vypršaná ponuka. Vyhľadajte, počkajte dlhšie, než je životnosť ponuky u dodávateľa, a potom rezervujte. Je vypršanie samostatná chyba, alebo tá istá chyba ako „dodávateľ nedostupný“?
  • Vypredané pri rezervácii. Inventár, ktorý zmizne medzi cenou a rezerváciou. V akom stave je rezervácia a uvoľní sa autorizácia platby?
  • Opakovanie po timeoute. Pošlite požiadavku na rezerváciu, zrušte spojenie pred odpoveďou a pošlite ju znova. Máte teraz jeden PNR, alebo dva? Tento jediný test vám o dodávateľovi povie viac než zvyšok skúšobnej verzie dokopy.
  • Rezervácia vytvorená, vystavenie zlyhalo. Vie API ohlásiť PNR, ktorý existuje, ale nie je vystavený, a povie vám termín na vystavenie?
  • Čiastočné zlyhanie. Hotelová požiadavka na viac izieb, kde jedna izba sa potvrdí a druhá nie. Spiatočný let, kde tam a späť pochádzajú z rôznych zdrojov.
  • Storno mimo bezplatného okna. Je pokuta uvedená pred potvrdením, alebo ju objavíte až na faktúre?
  • Výpadok dodávateľa. Opýtajte sa dodávateľa, ako ho nasimulovať. Ak nevie, opýtajte sa, ako jeho klienti zistili, ako sa systém správa.

Pri každom prípade hodnotíte dve veci. Po prvé: povie vám API pravdu o stave rezervácie? Po druhé: vie váš kód na tú pravdu zareagovať bez toho, aby človek čítal voľný text? S API, ktoré zlyháva jasne, sa žije ľahšie než s tým, ktoré uspeje nejednoznačne.

Leteckej strane sme sa podrobnejšie venovali v článku o tom, čo dokumentácia API na rezerváciu leteniek vynecháva, a návrhu klienta pre pomalých hotelových dodávateľov v článku o hotelovej dostupnosti. Oba sú užitočnými spoločníkmi k plánu skúšobnej verzie.

Otázky, ktoré odhalia slabého agregátora

Na agregátore nie je nič zlé. Väčšina cestovného obsahu sa k väčšine predajcov dostáva práve cez jedného. Riziko je ten slabý: vrstva, ktorá ďalej predáva API inej vrstvy, pridá si maržu a nevlastní ani zmluvu s dodávateľom, ani operačný desk. Keď sa niečo pokazí, odpoveď musí prejsť dve firmy proti prúdu a späť.

Päť otázok to vynesie na povrch rýchlo:

  1. Kto je dodávateľom záznamu pre túto rezerváciu? Na čej zmluve s aerolíniou alebo hotelom stojí?
  2. Cez čie číslo IATA a BSP ide letenka? Ak je odpoveď „partnerovo“, opýtajte sa, komu príde ADM, keď sa poruší tarifné pravidlo.
  3. Keď zavolám storno, čo sa stane na vašej strane? Automatizované volanie dodávateľovi, alebo fronta, ktorú vyberá človek?
  4. Uvidím chybu z upstreamu? Slabá vrstva má sklon sploštiť každé zlyhanie do jedného kódu, lebo chybám, ktoré dostáva, celkom nerozumie.
  5. Komu volám kvôli zaseknutej živej rezervácii a komu volá on? Spočítajte skoky.

Žiadna z týchto odpovedí sama osebe nevylučuje. Číslo IATA partnera môže byť v poriadku, ak zmluva jasne hovorí, kto nesie debetné memorandum. Dôležité je, aby dodávateľ odpovedal presne a rýchlo. Vágne odpovede tu sú presne tie, ktoré dostanete neskôr — v produkcii a v horšiu hodinu.

Čo vás stojí zlé rozhodnutie

Integrácia je lacná časť. Drahé časti prídu neskôr a v žiadnom odhade nie sú.

Chyba s duplicitnou rezerváciou znamená zákazníka, ktorému ste strhli peniaze dvakrát, a PNR, ktorý musíte nájsť a zrušiť ručne, možno až po zatvorení bezplatného okna na void. Rezervácia, ktorá upstream prešla, zatiaľ čo vaša strana zaznamenala zlyhanie, znamená držané miesto, potom automatické zrušenie a zákazníka, ktorý verí, že má rezervované. Dopravca, ktorého ste zobrazili, no nevedeli vystaviť, znamená refundáciu, ospravedlnenie a zákazníka, ktorý sa nevráti. ADM za tarifné pravidlo, ktoré porušila cesta dodávateľa, dopadne na toho, kto letenku vlastní — vopred si overte, či ste to vy.

A potom náklady na zmenu. Každá zvláštnosť dodávateľa, ktorú absorbujete — stavový kód, ktorý znamená dve veci, pole, ktoré je niekedy reťazec — skončí vo vašom dátovom modeli. Po dvoch rokoch už voľba API nie je integrácia, ktorú vymeníte za jeden šprint; je to tvar vašej tabuľky rezervácií. To je skutočný dôvod porovnávať starostlivo teraz.

Ako do tohto rámca zapadá naše vlastné API

Ponúkame letecké a hotelové API. Prístup začína rozhovorom, nie samoobslužným kľúčom, čo niektorým vývojárom pripadá pomalé; dôvod je, že práve v tom rozhovore sa otázky vyššie kladú oboma smermi — ktoré trasy a mestá potrebujete, ktorý obsah naozaj budete vedieť vystaviť či potvrdiť a kto čo rieši po rezervácii. Ak robíte porovnanie, prineste si tento zoznam. Rozhovor začína na stránke travel API.

Nech si vyberiete čokoľvek, vyberajte podľa záznamu zo skúšobnej verzie, nie podľa prezentácie. Prezentácia vám povie, čím chce dodávateľ byť. Chybové cesty vám povedia, čím je.

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.