Přeskočit na obsah
Blog

Srovnání travel API: hodnoťte osy, ne dodavatele

Redakce Tekravel
Napsáno s pomocí AI

Máte otevřené tři prezentace dodavatelů ve třech záložkách. Každá má slajd s dlouhým seznamem aerolinek, slajd s počtem hotelů, sandbox, REST a JSON a e-mail na podporu. Postavíte tabulku, zaškrtnete každou buňku a tabulka skončí remízou. Tak obvykle končí srovnání travel API dělané jako checklist funkcí — a je to špatný konec, protože rozdíly, které rozhodnou váš příští rok, se ukážou až po spuštění: u rezervace, která u dodavatele prošla, ale na vaší straně skončila timeoutem, u refundace, kterou nikdo neumí zpracovat, u aerolinky, která byla v seznamu, ale touto cestou se na ni nedá vystavit letenka.

Tento text je pro vývojáře nebo technického vedoucího, který musí rozhodnout a později své rozhodnutí obhájit. Neřadí dodavatele do žebříčku. Dává vám osy pro srovnání, plán testování, který tráví čas na chybových scénářích, a krátkou sadu otázek, podle kterých rychle poznáte, jestli mluvíte s dodavatelem, nebo s přeprodejcem cizího dodavatele.

Proč checklist funkcí vždycky končí remízou

Checklist se ptá, jestli nějaká schopnost existuje. Téměř každé travel API řekne „ano“ téměř na každý řádek, protože řádky jsou napsané na úrovni marketingové stránky: vyhledání, cena, rezervace, storno, vystavení, webhooky, sandbox. To, co je odlišuje, není existence cancel, ale co se stane, když ho zavoláte na vystavenou letenku dvanáct hodin před odletem, na tarif s poplatkem, přes cestu, kde obsah přišel od třetí strany. Na to checklist sloupec nemá.

Je tu i druhý problém. Checklist obvykle vyplňuje sám dodavatel. Hodnotíte jeho vlastní popis.

Srovnání travel API podle os, ne podle dodavatelů

Mřížku „dodavatel × funkce“ nahraďte osami, které hodnotíte sami, z důkazů nasbíraných během zkušebního provozu. Tabulka níže je ta, kterou bychom použili my. Řádky můžete vážit jinak — firma prodávající jen hotely se o vystavování letenek stará méně — a než ji převezmete, měli byste se s ní pohádat.

OsaNa co se ptá checklistCo skutečně zjistitJak zní slabá odpověď
PokrytíKolik aerolinek a hotelů?Kolik z nich jde přes toto API vyhledat, zarezervovat A vystavit či potvrdit — na vašich trzíchJedno velké číslo bez rozpadu
HloubkaExistuje endpoint pro storno?Které akce po rezervaci jsou automatizované pro každý zdroj obsahu: void, refund, reissue, oprava jména, doplňkové služby„To řeší náš operations tým“
Integrita cenyJsou ceny v reálném čase?Jak často se cena při rezervaci liší od ceny při vyhledání a jak vám to API sdělí„Ceny jsou vždycky živé“
Sémantika chybJsou chyby zdokumentované?Jestli vám chyba řekne, v jakém stavu rezervace je, ne jen že něco selhaloJeden obecný kód pro každé selhání
Idempotence—Jestli opakované volání book může vytvořit druhou rezervaciTicho, pak „to jsme neviděli“
Dodavatel záznamu—Čí smlouva, čí číslo IATA, čím BSP letenka prochází„Pracujeme se všemi velkými GDS“
Přístup a podporaJe k dispozici sandbox?Kdo odpoví, když se zasekne živé PNR, a jak rychleFormulář na tikety a žádné jméno

Dva z těch řádků nemají v checklistu žádnou otázku. Není to náhoda: jsou to řádky, které stojí nejvíc, když se něco pokazí, a které prezentace dodavatele sama od sebe zmíní nejméně.

Pokrytí není hloubka

Seznam aerolinek je nejzavádějící slajd každé prezentace. Seznam několika set dopravců může znamenat několik různých věcí a jen jedna z nich je to, co chcete.

Někteří přicházejí přes GDS a dají se zarezervovat i vystavit od začátku do konce. Jiní přes NDC připojení, kde vyhledávání může fungovat dobře, ale servis po rezervaci — změny, částečné refundace, přidání zavazadla — může být u té aerolinky pořád ruční. Někteří jsou nízkonákladoví dopravci, jejichž obsah agreguje jiný přeprodejce; zobrazit je můžete, někdy i zarezervovat, a pak letenka dorazí cestou, kterou nemáte pod kontrolou, v termínu, který zákazníkovi nemůžete slíbit. A někteří jsou v seznamu, protože se jednou ve výsledcích hledání objevil jejich tarif.

Dopravce, kterého umíte zobrazit, ale ne vystavit, není pokrytí. Pro retailový produkt je horší než jeho absence, protože zákazník si ho vybere, zaplatí a pak čeká.

Hotely mají stejný tvar, jen jiná slova. Počet ubytování zahrnuje objekty, které dodavatel namapoval, i ty, které ne; statické ceny uložené minulý týden vedle živé dostupnosti; pokoje na allotmentu s release periodou vedle free sale. Ptejte se na počet, který je živě rezervovatelný ve městech, kde prodáváte, a ptejte se, jak slučují duplicity mezi vlastními dodavateli — stejný hotel třikrát za tři ceny je tiket na podporu, který jen čeká na svou chvíli.

Praktický test je úzký. Sepište dvacet tras a dvacet hotelových měst, která tvoří většinu vašeho objemu — třeba Praha–Londýn, Brno–Antalya, Vídeň, Barcelona — a požádejte dodavatele, aby vám v sandboxu ukázal přesně tyto fungovat od začátku do konce: vyhledání, cena, rezervace, vystavení nebo potvrzení, storno. Dodavatel, který má hloubku, to udělá bez řečí. Dodavatel, který má slajd, začne mluvit o slajdu.

Co testovat ve zkušebním provozu: chybové cesty, ne šťastné

Každý sandbox úspěšně zarezervuje jednosměrnou letenku v ekonomické třídě na klidné trase. Přesně kvůli tomu byl postaven. Váš produkční provoz stráví podstatnou část života na těch ostatních cestách a zkušební období je jediná levná chvíle, kdy je uvidíte.

Projděte tento seznam a zapisujte, co API vrátilo, vedle toho, co pak skutečně platilo:

  • Změna ceny mezi vyhledáním a rezervací. Selže volání book, projde za novou cenu, nebo vrátí samostatnou odpověď s žádostí o potvrzení? Pozná to vaše UI bez parsování textu zprávy?
  • Prošlá nabídka. Vyhledejte, počkejte déle, než je platnost nabídky, pak rezervujte. Je vypršení samostatná chyba, nebo stejná jako „dodavatel nedostupný“?
  • Vyprodáno při rezervaci. Kapacita, která zmizí mezi naceněním a rezervací. V jakém stavu je rezervace a uvolní se autorizace platby?
  • Opakování po timeoutu. Pošlete požadavek na rezervaci, přerušte spojení před odpovědí a pošlete ho znovu. Máte teď jedno PNR, nebo dvě? Tento jediný test vám o dodavateli řekne víc než celý zbytek zkušebního provozu dohromady.
  • Rezervace vytvořena, vystavení selhalo. Umí API ohlásit PNR, které existuje, ale není vystavené, a řekne vám termín pro vystavení?
  • Částečné selhání. Hotelový požadavek na více pokojů, kde se jeden potvrdí a druhý ne. Zpáteční let, kde cesta tam a zpět pocházejí z různých zdrojů.
  • Storno mimo bezplatné okno. Dozvíte se poplatek před potvrzením, nebo až z faktury?
  • Výpadek dodavatele. Zeptejte se, jak ho nasimulovat. Pokud to neumějí, zeptejte se, jak se jejich klienti dozvěděli, jak se API chová.

U každého případu hodnotíte dvě věci. Za prvé: říká vám API pravdu o stavu rezervace? Za druhé: dokáže na tu pravdu reagovat váš kód, aniž by člověk četl volný text? S API, které selhává jasně, se žije snáz než s takovým, které uspívá nejednoznačně.

O letové části jsme podrobněji psali v článku co dokumentace API pro rezervaci letenek zamlčí a o návrhu klienta pro pomalé hotelové dodavatele v textu o dostupnosti hotelů. Oba se k plánu testování hodí.

Otázky, které odhalí „tenkého“ agregátora

Na agregátorovi není nic špatného. Většina cestovního obsahu se k většině prodejců dostává právě přes nějakého. Riziko představuje ten tenký: vrstva, která přeprodává API jiné vrstvy, přidá marži a nevlastní ani smlouvu s dodavatelem, ani operační oddělení. Když se něco rozbije, odpověď musí cestovat dvě firmy nahoru a zpátky.

Pět otázek to rychle vytáhne na světlo:

  1. Kdo je dodavatelem záznamu pro tuto rezervaci? Na čí smlouvě s aerolinkou nebo hotelem stojí?
  2. Přes čí číslo IATA a čí BSP letenka jde? Pokud je odpověď „partnerovo“, zeptejte se, kdo dostane ADM, když se poruší tarifní pravidlo.
  3. Co se u vás stane, když zavolám cancel? Automatické volání dodavateli, nebo fronta, kterou zpracuje člověk?
  4. Uvidím chybu z upstreamu? Tenká vrstva má sklon slít každé selhání do jednoho kódu, protože chybám, které dostává, plně nerozumí.
  5. Komu zavolám kvůli zaseknuté živé rezervaci a komu volá on? Spočítejte skoky.

Žádná z odpovědí sama o sobě nediskvalifikuje. Partnerovo číslo IATA může být v pořádku, pokud smlouva jasně říká, kdo nese debit memo. Podstatné je, že dodavatel odpovídá přesně a rychle. Vágní odpovědi tady jsou přesně ty, které dostanete později — v produkci, v horší hodinu.

Kolik stojí špatná volba

Integrace je ta levná část. Drahé části přijdou později a v žádném odhadu nejsou.

Chyba s duplicitní rezervací znamená zákazníka strženého dvakrát a PNR, které musíte ručně najít a zrušit, možná až po zavření bezplatného okna pro void. Rezervace, která upstream prošla, zatímco vaše strana zaznamenala selhání, znamená držené místo, pak automatické zrušení a zákazníka, který si myslí, že má rezervaci. Dopravce, kterého jste zobrazili, ale nedokázali vystavit, znamená refundaci, omluvu a zákazníka, který se nevrátí. ADM za tarifní pravidlo, které porušila cesta dodavatele, dopadne na toho, komu letenka patří — vězte předem, jestli jste to vy.

Pak jsou tu náklady na změnu. Každá zvláštnost, kterou vstřebáte — stavový kód se dvěma významy, pole, které je někdy string — skončí ve vašem datovém modelu. Po dvou letech už volba API není integrace, kterou vyměníte za sprint; je to tvar vaší tabulky rezervací. To je skutečný důvod srovnávat pečlivě teď.

Jak do tohoto rámce zapadá naše vlastní API

Nabízíme letové a hotelové API. Přístup začíná rozhovorem, ne samoobslužným klíčem, což někteří vývojáři považují za pomalé; důvod je, že právě v tom rozhovoru padají výše uvedené otázky oběma směry — které trasy a města potřebujete, který obsah budete skutečně moci vystavit nebo potvrdit a kdo co řeší po rezervaci. Pokud srovnáváte, přineste si tento seznam. Stránka travel APIs je místo, kde ten rozhovor začíná.

Ať zvolíte cokoli, volte podle záznamu ze zkušebního provozu, ne podle prezentace. Prezentace vám řekne, čím chce dodavatel být. Chybové cesty vám řeknou, čím je.

Redakce Tekravel

Rubrika cestovních technologií

Rubrika cestovních technologií Tekravel píše pro obor: majitele agentur, konsolidátory a vývojáře, kteří je integrují. Každý článek je před vydáním ověřen na platformě, kterou popisuje.