Přeskočit na obsah
Blog

Testování travel API v sandboxu: co vám sandbox neukáže

Redakce Tekravel
Napsáno s pomocí AI

Integrace prošla vším, co na ni testování travel API v sandboxu dokázalo hodit. Vyhledávání vracelo lety, dotaz na dostupnost hotelů vracel pokoje, rezervační volání pokaždé vrátilo číslo potvrzení a QA to ve čtvrtek schválilo. Následující úterý zaplatil zákazník hotel za jednu cenu a dodavatel ho potvrdil za jinou, rezervace letu skončila timeoutem a nikdo nevěděl, jestli je místo blokované, a pracovník podpory strávil odpoledne párováním dvou záznamů téže cesty. Nic z toho nebyla chyba, kterou testy přehlédly. Byly to scénáře, které testy neměly jak uvidět. Sandbox je nutný, zdaleka ale nestačí, a v mezeře mezi těmi dvěma věcmi žije většina drahých incidentů cestovní integrace.

Tohle je testovací plán pro vývojáře, který za integraci odpovídá: co sandbox dokázat umí, co ze své podstaty neumí a jak rozdíl pokrýt, aniž byste na firemní kartu kupovali skutečná místa.

Proč testování travel API v sandboxu pustí kód, který produkce rozbije

Sandbox slibuje tvar odpovědí, ne jejich chování. Schéma odpovídá produkci. Chování skoro nikdy — a není to ničí vina: testovací prostředí si nemůže dovolit živý inventář, takže servíruje pevnou sadu tarifů a pokojů, které se nevyprodají, nemění cenu a nemění letový řád. Odpovídá rychle, protože ho nikdo jiný nepoužívá. Málokdy selže v polovině.

Produkce dělá všechno z toho denně. Inventář sdílíte se všemi ostatními prodejci; tarify si někdo výš v řetězci drží v cache a ty stárnou; systém dodavatele pod zátěží odpovídá pomalu, nebo vůbec. Kód, který viděl jen sandbox, byl ve skutečnosti testován jen proti dodavateli, který má dokonalý den.

Berte proto sandbox jako jednu ze tří vrstev. Dokazuje, že požadavky mají správný tvar a parser rozumí schématu. Nahrané fixtures dokazují, že kód přežije odpovědi, které produkce skutečně posílá. Malá, záměrně zvolená sada živých kontrol dokazuje zapojení po každé změně. Každá vrstva chytí to, co ostatní dvě ne.

Scénáře, které vám sandbox obvykle nedá

Sepište je dřív, než napíšete první test. Sandbox možná jeden či dva nasimuluje přes nějakou „magickou“ testovací hodnotu; většinu prostě nemá.

ScénářCo udělá produkceJak ho pokrýt
Změna ceny mezi vyhledáním a rezervacíRezervace projde s jinou celkovou částkou, nebo selže s chybou změny ceny, kterou musíte zobrazitPár fixtures: odpověď vyhledávání a odpověď rezervace s jinou částkou; ověřit, že se cestujícího znovu zeptáte a nikdy ho potichu nestrhnete
Vyprodáno mezi dostupností a rezervacíPokoj nebo tarifní třída z nabídky už neexistuje, když ji chcete zablokovatFixture se skutečnou chybou vyprodání od dodavatele; ověřit, že se cestující vrátí na výsledky, ne na chybovou stránku
Timeout rezervačního voláníDodavatel rezervaci možná vytvořil, možná neVyvolat timeout po odeslání požadavku; ověřit, že se před jakýmkoli opakováním zeptáte na stav rezervace
Dvojité odesláníDvojklik nebo retry na straně klienta vytvoří dvě rezervacePoslat tutéž rezervaci dvakrát se stejným idempotency key; ověřit, že existuje přesně jedna
Změna letového řádu po vystavení letenkyProdaný let teď odlétá jindy nebo pod jiným číslemFixture změněného itineráře; ověřit, že změna dorazí k tomu, kdo má zákazníka na starosti
Částečný úspěch vícepoložkové rezervaceLet se potvrdí, hotel neSmíšená fixture; ověřit, že systém zaznamená přesně to, co bylo potvrzeno, a upozorní člověka
Throttling pod zátěžíOdpovědi rate limitu, pak pomalé odpovědiPřehrát nahranou throttling odpověď; ověřit backoff a že vyhledávání degraduje, místo aby padalo

S posledním sloupcem můžete pro svůj stack nesouhlasit. To je v pořádku. Podstatné je, aby každý řádek měl vlastníka a aserci, protože každý z nich vás jednou potká.

Fixtures ze skutečných odpovědí, ne vymyšlených

Nejužitečnější návyk v cestovní integraci je schovávat si odpovědi, které vás překvapily. Ručně psaná mock data odrážejí, co si myslíte, že dodavatel posílá; nahraná odpověď ukazuje, co skutečně poslal — včetně polí, která jsou prázdná, ač dokumentace tvrdí, že nikdy nejsou, ceny v měně, o kterou jste nežádali, a chyby, která přijde se stavovým kódem úspěchu.

Rutina, která funguje:

  • Nahrávejte na hranici. Logujte surová těla požadavků a odpovědí volání dodavatelů v neprodukčním prostředí, a v produkci pro vzorek provozu, pokud to vaše pravidla ochrany osobních údajů dovolí.
  • Než uložíte, vyčistěte. Jména cestujících, čísla pasů, e-maily, telefony a platební reference musí pryč dřív, než fixture vstoupí do repozitáře. Nahraďte je zjevně falešnými hodnotami, aby si nikdo fixture nespletl se skutečnou rezervací.
  • Pojmenovávejte podle chování. hotel-book-price-increased.json řekne dalšímu vývojáři, proč existuje; response-17.json ne.
  • Ošklivé si nechte navždy. Poškozená odpověď, která jednu neděli shodila vyhledávání, je nejcennější soubor, jaký máte. Patří do testu, který běží při každém commitu.

Pak nad těmi fixtures napište contract testy: na parser, na mapování do interních modelů, na klasifikaci chyb. Když dodavatel přejmenuje pole a contract test selže, dozvíte se to v CI, a ne od zákazníka. Klasifikaci chyb podrobněji rozebírá náš článek o zpracování chyb v API rezervačního systému.

Testování peněžních cest bez utrácení peněz

Tady sandbox pomáhá nejméně, protože právě v peněžních cestách se testovací prostředí od skutečného liší nejvíc. Skutečné vystavení letenek, skutečné stržení z karty a skutečná fakturace od dodavatele jsou věci, které musíte mít nejvíc v pořádku, a zároveň ty, které si nejméně můžete naživo vyzkoušet.

Rozdělte problém. Výpočet ceny je čistá logika a dá se offline otestovat vyčerpávajícím způsobem: vezměte nahrané tarify, aplikujte pravidla markupu, převod měn a zaokrouhlení a ověřte částku, kterou cestující vidí. Udělejte to pro nepříjemné případy — tarif v eurech prodávaný v korunách, markup, který je u jednoho produktu procentem a u jiného pevnou částkou, dětský tarif, zaokrouhlení, které se liší mezi zobrazením a stržením. Částka, která nesedí o pár korun, je pořád špatně, a to u každé rezervace.

Druhou polovinou jsou stavové přechody kolem platby. Modelujte je explicitně — nabídnuto, blokováno, zaplaceno, potvrzeno, vystaveno, zrušeno, vráceno — a ověřte, že každý přechod má právě jednu příčinu. Test, který chytí nejdražší chybu, ověřuje, že nelze strhnout platbu za rezervaci, kterou dodavatel nepotvrdil, a že potvrzená rezervace nemůže existovat bez záznamu o platbě.

Nakonec zařiďte, aby se testovací běh nemohl dostat k živému vystavování letenek. Ne nepravděpodobné; nemožné. Kontrola při startu, která odmítne spustit sadu testů, když jsou načtené produkční přihlašovací údaje, stojí jeden řádek a zabrání nejhoršímu ránu, jaké integrační tým může zažít.

Kolik vás stojí, když to uděláte špatně

Přehlédnutý scénář se v cestovní integraci málokdy projeví jako chyba. Projeví se jako rezervace, která vypadá v pořádku. Duplicitní letenka, o kterou nikdo nežádal a kterou někdo musí stihnout zvoidovat. Hotel potvrzený za cenu, kterou teď musí spolknout agentura. Rezervace po timeoutu, kterou systém zopakoval, takže dodavatel drží dva pokoje a fakturuje oba. U letenky prodané přes agenturu se nesoulad mezi vystaveným a prodaným může později vrátit jako ADM, dávno poté, co marže z toho prodeje byla utracena.

Tyhle náklady dopadají na firmu, která cestu prodala, ne na vývojáře, který napsal retry smyčku. V tom je celý argument, proč je otestovat před spuštěním, místo abyste je poznávali jeden tiket podpory po druhém.

Co otestovat po každé změně u dodavatele

Dodavatelé věci mění: nová verze API, nový endpoint, vyměněné přihlašovací údaje, jiné mapování obsahu. Váš vlastní kód se možná vůbec nezměnil. Projděte tenhle seznam stejně, v prostředí, které mluví se změněným dodavatelem:

  1. Jedno vyhledávání pro každý produkt, který od dodavatele prodáváte, na trase nebo ve městě, kde víte, že výsledky budou.
  2. Zpracujte každý výsledek a žádný potichu nezahoďte; porovnejte svůj počet s tím, co obsahuje surová odpověď.
  3. Naceňte jeden výsledek od začátku do konce a porovnejte zobrazenou částku s vlastním výpočtem ze surového tarifu.
  4. Vytvořte rezervaci v testovacím prostředí, přečtěte zpět její stav a porovnejte každé pole, které ukládáte.
  5. Zrušte ji a ověřte, že zrušení je vidět ve vašich záznamech i na straně dodavatele.
  6. Prožente uložené „ošklivé“ fixtures novým parserem.
  7. Zkontrolujte, že timeouty a rate limity pořád vedou k chování, na kterém jste se dohodli, protože nová verze na ně může odpovídat jinak. Pokud se posunuly doby odezvy, článek o latenci vysvětluje, kterou část můžete opravit vy.

Dost krátké, aby se to dalo pouštět pokaždé — a o to jde. Smoke test, který nikdo nespouští, protože trvá den, není smoke test.

Kam sandbox patří

Nic z toho nedělá sandbox méně užitečným. Dělá ho to poctivým: je to místo, kde se naučíte schéma a ověříte, že požadavky jsou správně, než převezmou fixtures a živé kontroly to, kam sandbox nedosáhne. Pokud vybíráte letová a hotelová API platformy, přístup začíná rozhovorem, ne samoobslužným klíčem — přineste si do toho rozhovoru tenhle testovací plán a zeptejte se, jak by byl pokrytý každý řádek tabulky výše. Odpovědi vám o API řeknou víc než jeho dokumentace.

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.