Nejlepší API pro rezervaci letenek: nejdřív řekněte, co stavíte

Zadání zní: najděte nejlepší API pro rezervaci letenek. Otevřete tedy tři srovnávací stránky a ty seřadí stejnou hrstku jmen třemi různými způsoby, každá s tabulkou plnou zaškrtnutí. U třetí stránky si všimnete, na co se žádná nezeptala: co se stane se zákazníkem, když se výsledky vyhledávání vrátí.
Ta chybějící otázka je celá odpověď. Nejlepší API pro rezervaci letenek pro stránku, která posílá návštěvníky na web letecké společnosti, je špatná volba pro web, který si rezervaci i platbu kartou bere sám. A ani jedno nesedí na interní nástroj, se kterým personál agentury pracuje celý den. Vyhledávání, cena a rezervace vypadají v každé dokumentaci stejně. Rozdíly leží pod nimi, a který z nich vás bude bolet, závisí čistě na produktu.
Tři produkty, kterým všichni říkají „web pro rezervaci letenek“
Prvním je srovnávací nebo inspirační stránka: ukáže tarify, pošle odkazem dál, letenky se nikdy nedotkne. Tady je API skoro jen vyhledávání. Zajímá vás, jak široké a čerstvé jsou výsledky a zda je zobrazená cena dost blízko té, kterou návštěvník uvidí po příchodu. Nic ve vašem systému nikdy nebude muset dělat void, refundaci ani přeúčtování, takže síla dodavatele v tomhle je pro vás promarněná.
Druhý prodává. Návštěvník platí vám, vy rezervujete, a od té chvíle je celý životní cyklus rezervace váš: potvrdit cenu před stržením platby, zvládnout leteckou společnost, která odpovídá pomalu, stornovat týž den, později vrátit peníze, přeúčtovat, když zákazník změní datum. U tohoto produktu je endpoint vyhledávání ta snadná část. O výběru rozhoduje to, co přijde po něm.
Třetím je vlastní nástroj agentury pro personál, který už má vztahy s dodavateli. Holé vyhledávání tu není cílem. Záleží na tom, aby se zobrazoval vlastní vyjednaný obsah agentury, aby subagenti drželi úvěrové limity, aby se přirážky uplatnily dřív, než někdo cenu uvidí, a aby na konci měsíce existovaly reporty. API výborné pro druhý produkt může být tady přesto špatným základem.
Je dobré to říct na rovinu: totéž API nemůže být nejlepší ve všech třech. Pokud to žebříček tvrdí, s tím druhým se nikdy nepotkal.
Vlastnosti, které má smysl srovnávat, a kdo se o ně opírá
Osekejte tabulku funkcí na řádky, o kterých by se vývojář mohl skutečně přít. Každý produkt se opírá o jinou podmnožinu, zbytek můžete klidně ignorovat.
| Vlastnost | Přesměrovací stránka | Prodává a přijímá platby | Nástroj pro personál agentury |
|---|---|---|---|
| Jak stará smí zobrazená cena být, než se potvrdí | Trochu důležité | Rozhodující: podle ní strháváte | Důležité, personál podle ní nabízí |
| Co vrátí rezervace, když letecká společnost odpovídá pomalu | Netýká se | Rozhodující | Důležité |
| Kdo může stornovat a vrátit peníze a jak se o to žádá | Netýká se | Rozhodující | Rozhodující |
| Jak se řeší rezervace s neznámým výsledkem | Netýká se | Rozhodující: karta už mohla být stržena | Důležité |
| Zda platí vlastní obsah a úvěrová pravidla agentury | Netýká se | Někdy | Rozhodující |
| Jak se testovací chování liší od ostrého | Nízko | Vysoko | Vysoko |
Čtěte svůj sloupec a ostatní ignorujte. Chyba, která stojí peníze, je číst sloupec přesměrování, protože se hodnotí nejsnáz, a stavět druhý produkt.
Cena, kterou ukazujete, ještě není cena, kterou strhnete
Vezměte druhý produkt a sledujte jím jeden tarif. Vyhledávání vrátí cenu. Návštěvník se na ni podívá, přemýšlí, otevře jinou záložku a vrátí se. Po nějaké době stiskne tlačítko. Mezi vyhledáváním a tlačítkem tarif ležel ve vašem systému a jediná poctivá otázka o jakémkoli API zní: co odpoví, když se zeptáte znovu právě v tu chvíli.
Dodavatel může dát tři odpovědi. Může potvrdit cenu, kterou jste ukázali. Může vrátit novou cenu a váš kód musí rozhodnout, zda strhnout rozdíl, zeptat se zákazníka, nebo skončit. Anebo může říct, že tarif zmizel. Web připravený jen na první odpověď funguje při každé ukázce a selže v následujících týdnech, a selže tak, že to stojí peníze, ne že to hází chyby.
Otázka návrhu tedy není, zda API má krok potvrzení ceny. Mají ho skoro všechna. Jde o to, jak odpověď vypadá ve všech třech případech a zda je váš kód dokáže rozlišit bez hádání. Požádejte o příklad každého. Dodavatel, který druhý a třetí ukazuje v dokumentaci, myslel na váš produkt. Ten, kdo ukazuje jen první, myslel na ukázku.
Test na jedno odpoledne, který vám žádná tabulka nedá
Ať je užší výběr jakýkoli, udělejte s každým jménem stejný krátký test a selhání vyvolejte schválně. Něco zarezervujte a podívejte se, co si objekt rezervace drží po vystavení letenky. Ověřte cenu stejné trasy dvakrát, s odstupem několika minut, a srovnejte druhou odpověď s první. Stornujte, pak požádejte o vrácení peněz a zapište si, kdo musí jednat. Potom dodavateli písemně položte dvě otázky: co váš systém vrátí, když letecká společnost uprostřed rezervace vyprší na timeout, a jak zjistím, co se doopravdy stalo.
Písemné odpovědi mají větší cenu než ukázka. Dodavatel s jasným postupem pro neznámý výsledek se s problémem už setkal. Ten, kdo odpoví názvem funkce, ne.
Jak sestavit samotný testovací plán, rozebírá plán testování v sandboxu, včetně toho, co vám sandbox neukáže. A pokud dodavatele vážíte podle toho, co stojí za API, a ne podle API samotného, je to samostatná otázka s vlastním článkem; tenhle zůstává u produktu.
Kolik zaplatíte, když vybíráte podle seznamu endpointů
Selhání jsou tichá. Web potvrzuje ceny pozdě, takže rozdíl mezi zobrazeným a skutečným tarifem jde z vaší marže, rezervaci po rezervaci. Rezervace zůstane v neznámém stavu, zatímco karta zákazníka už byla stržena, a někdo to musí vyřešit ručně, obvykle e-mailem, obvykle o víkendu. Nástroj postavený na obsahu vhodném jen pro vyhledávání se ukáže jako něco, z čeho personál nemůže vystavovat letenky, a projekt se přestaví kolem jiného obsahu.
Nic z toho není vidět v tabulce se zaškrtnutím. Všechno bylo vidět v prvním sloupci tabulky výše, ještě před první řádkou kódu.
Naše vlastní pozice je užší, než by nám žebříček dovolil tvrdit. Tekravel nabízí API pro lety a hotely, přístup začíná rozhovorem, ne samoobslužným klíčem, služby se zapínají pro každý tenant zvlášť a obsah dodavatelů se k tenantovi dostává přes skupiny dodavatelů. To sedí na druhý a třetí produkt. Pokud stavíte první, možná nás vůbec nepotřebujete. Pokud stavíte některý z ostatních, stránka API je místo, kde začít rozhovor.