Prijeđi na sadržaj
Blog

Testiranje turističkog API-ja u sandboxu: što vam neće pokazati

Uredništvo Tekravel
Napisano uz pomoć umjetne inteligencije

Integracija je prošla sve što joj je testiranje turističkog API-ja u sandboxu moglo podmetnuti. Pretraga je vraćala letove, upit o raspoloživosti hotela vraćao je sobe, poziv za rezervaciju svaki je put vratio broj potvrde, a QA je odobrio u četvrtak. Sljedećeg utorka kupac je platio hotel po jednoj cijeni, a dobavljač ga je potvrdio po drugoj; rezervacija leta je istekla i nitko nije znao je li mjesto zadržano; a djelatnik podrške proveo je poslijepodne usklađujući dva zapisa o istom putovanju. Ništa od toga nije bio bug koji su testovi promašili. Bili su to scenariji koje testovi nikako nisu mogli vidjeti. Sandbox je nužan, daleko od toga da je dovoljan, a u jazu između to dvoje živi većina skupih incidenata turističke integracije.

Ovo je plan testiranja za programera koji odgovara za tu integraciju: što sandbox može dokazati, što po svojoj prirodi ne može i kako pokriti razliku, a da ne rezervirate prava sjedala službenom karticom.

Zašto testiranje turističkog API-ja u sandboxu propušta kod koji produkcija lomi

Sandbox obećava nešto o obliku odgovora, ne o njihovom ponašanju. Shema odgovara produkciji. Ponašanje gotovo nikad — i to nije ničija krivnja: testno okruženje si ne može priuštiti živi inventar, pa nudi fiksni skup tarifa i soba koje se nikad ne rasprodaju, ne mijenjaju cijenu i ne mijenjaju red letenja. Odgovara brzo jer ga nitko drugi ne koristi. Rijetko padne na pola posla.

Produkcija sve to radi svakodnevno. Inventar dijelite sa svim ostalim prodavačima; tarife netko više u lancu drži u cacheu i one zastarijevaju; sustav dobavljača pod opterećenjem odgovara sporo ili nikako. Kod koji je vidio samo sandbox praktički je testiran samo protiv dobavljača koji ima savršen dan.

Zato sandbox promatrajte kao jedan od tri sloja. On dokazuje da su zahtjevi ispravno složeni i da parser razumije shemu. Snimljeni fixtures dokazuju da kod preživljava odgovore koje produkcija stvarno šalje. Mali, namjerno odabran skup živih provjera dokazuje povezanost nakon svake promjene. Svaki sloj hvata ono što druga dva ne mogu.

Scenariji koje vam sandbox obično ne daje

Zapišite ih prije nego što napišete ijedan test. Sandbox možda simulira jedan ili dva pomoću neke „čarobne” testne vrijednosti; većinu jednostavno nema.

ScenarijŠto radi produkcijaKako ga pokriti
Promjena cijene između pretrage i rezervacijeRezervacija uspije s drugim ukupnim iznosom ili padne s greškom o promjeni cijene koju morate prikazatiPar fixtures: odgovor pretrage i odgovor rezervacije s različitim iznosom; provjerite da se putnika ponovno pita i nikad ne tereti potiho
Rasprodano između raspoloživosti i rezervacijePonuđena soba ili tarifni razred više ne postoje kad ih pokušate zadržatiFixture sa stvarnom greškom dobavljača za rasprodano; provjerite da se putnik vraća na rezultate, a ne na stranicu s greškom
Timeout pri pozivu rezervacijeDobavljač je možda napravio rezervaciju, a možda nijeIzazovite timeout nakon slanja zahtjeva; provjerite da pitate za status rezervacije prije bilo kakvog ponovnog pokušaja
Dvostruko slanjeDvoklik ili ponovni pokušaj klijenta stvara dvije rezervacijePošaljite istu rezervaciju dvaput s istim idempotency keyem; provjerite da postoji točno jedna
Promjena reda letenja nakon izdavanjaProdani let sada polijeće u drugo vrijeme ili pod drugim brojemFixture izmijenjenog itinerera; provjerite da promjena stiže do onoga tko vodi kupca
Djelomičan uspjeh višedijelne rezervacijeLet se potvrđuje, hotel neMješoviti fixture; provjerite da sustav bilježi točno ono što je potvrđeno i upozorava čovjeka
Throttling pod opterećenjemOdgovori o rate limitu, zatim spori odgovoriPustite snimljeni throttling odgovor; provjerite backoff i da pretraga degradira umjesto da pada

Možda se ne slažete sa zadnjim stupcem za svoj stack. U redu. Važno je da svaki redak ima vlasnika i assertion, jer će vam se svaki od njih kad-tad dogoditi.

Fixtures od pravih odgovora, ne izmišljenih

Najkorisnija navika u turističkoj integraciji je čuvanje odgovora koji su vas iznenadili. Ručno pisani mock podaci odražavaju ono što mislite da dobavljač šalje; snimljeni odgovor pokazuje što je stvarno poslao — uključujući polja koja su prazna iako dokumentacija kaže da nikad nisu, cijenu u valuti koju niste tražili i grešku koja stiže s kodom uspjeha.

Rutina koja funkcionira:

  • Snimajte na granici. Logirajte sirova tijela zahtjeva i odgovora prema dobavljačima u neprodukcijskom okruženju, a u produkciji za uzorak prometa, ako vaša pravila o zaštiti podataka to dopuštaju.
  • Očistite prije spremanja. Imena putnika, brojevi putovnica, e-mailovi, telefoni i platne reference uklanjaju se prije nego što fixture uđe u repozitorij. Zamijenite ih očito lažnim vrijednostima da nitko ne zamijeni fixture s pravom rezervacijom.
  • Imenujte po ponašanju. hotel-book-price-increased.json govori sljedećem programeru zašto postoji; response-17.json ne govori.
  • Ružne čuvajte zauvijek. Neispravan odgovor koji je jedne nedjelje srušio pretragu najvrjednija je datoteka koju imate. Mjesto mu je u testu koji se pokreće na svakom commitu.

Zatim napišite contract testove nad tim fixtures: za parser, za mapiranje u interne modele, za klasifikaciju grešaka. Ako dobavljač preimenuje polje i contract test padne, saznajete to u CI-ju, a ne od kupca. Klasifikaciju detaljnije obrađuje naš tekst o obradi pogrešaka u API-ju sustava za rezervacije.

Testiranje novčanih tokova bez trošenja novca

Tu sandbox pomaže najmanje, jer se upravo u novčanim tokovima testno okruženje razlikuje od pravog. Pravo izdavanje karata, pravo terećenje kartice i pravo fakturiranje dobavljača stvari su koje najviše moraju biti točne, a koje najmanje možete uvježbati uživo.

Podijelite problem. Izračun cijene čista je logika i može se iscrpno testirati offline: uzmite snimljene tarife, primijenite svoja pravila za markup, konverziju valute i zaokruživanje te provjerite iznos koji putnik vidi. Učinite to za nezgodne slučajeve — tarifa u dolarima prodana u eurima, markup koji je na jednom proizvodu postotak a na drugom fiksni iznos, dječja tarifa, zaokruživanje koje se razlikuje između prikaza i terećenja. Iznos koji odstupa za nekoliko centi i dalje je pogrešan — i pogrešan je na svakoj rezervaciji.

Druga polovica su prijelazi stanja oko plaćanja. Modelirajte ih eksplicitno — ponuđeno, zadržano, plaćeno, potvrđeno, izdano, otkazano, refundirano — i provjerite da svaki prijelaz ima točno jedan uzrok. Test koji hvata najskuplji bug provjerava da se plaćanje ne može naplatiti za rezervaciju koju dobavljač nije potvrdio i da potvrđena rezervacija ne može postojati bez zapisa o plaćanju.

Na kraju, učinite nemogućim da testno pokretanje stigne do živog izdavanja karata. Ne malo vjerojatnim; nemogućim. Provjera pri pokretanju koja odbija pustiti testove kada su učitane produkcijske vjerodajnice stoji jedan redak i sprječava najgore jutro koje integracijski tim može doživjeti.

Koliko vas košta ako pogriješite

Promašeni scenarij u turističkoj integraciji rijetko se pojavi kao greška. Pojavi se kao rezervacija koja izgleda uredno. Dupla karta koju nitko nije tražio i koju netko mora voidati prije roka. Hotel potvrđen po cijeni koju agencija sada mora sama pokriti. Rezervacija s timeoutom koju je sustav ponovno pokušao, pa dobavljač drži dvije sobe i fakturira obje. Kod zrakoplovne karte prodane preko agencije, nesklad između izdanog i prodanog može se kasnije vratiti kao ADM, dugo nakon što je marža od te prodaje potrošena.

Ti troškovi padaju na tvrtku koja je prodala putovanje, ne na programera koji je napisao retry petlju. U tome je cijeli argument da ih testirate prije pokretanja, umjesto da ih učite jedan tiket podrške za drugim.

Što provjeriti nakon svake promjene kod dobavljača

Dobavljači mijenjaju stvari: nova verzija API-ja, novi endpoint, promijenjene vjerodajnice, drukčije mapiranje sadržaja. Vaš se kod možda uopće nije promijenio. Prođite ovaj popis svejedno, u okruženju koje razgovara s promijenjenim dobavljačem:

  1. Po jedna pretraga za svaki proizvod koji prodajete od tog dobavljača, na relaciji ili u gradu za koji znate da vraća rezultate.
  2. Obradite svaki rezultat, a da nijedan potiho ne ispadne; usporedite svoj broj s onim što sadrži sirovi odgovor.
  3. Obračunajte jedan rezultat od početka do kraja i usporedite prikazani iznos s vlastitim izračunom iz sirove tarife.
  4. Napravite rezervaciju u testnom okruženju, pročitajte natrag njezin status i usporedite svako polje koje spremate.
  5. Otkažite je i potvrdite da je otkazivanje vidljivo i u vašim zapisima i kod dobavljača.
  6. Provucite spremljene ružne fixtures kroz novi parser.
  7. Provjerite da timeouti i rate limiti i dalje vode ponašanju o kojem ste se dogovorili, jer nova verzija na njih može odgovarati drukčije. Ako su se vremena odziva pomaknula, tekst o latenciji objašnjava koji je dio vaš da ga popravite.

Dovoljno kratko da se pušta svaki put — i to je poanta. Smoke test koji nitko ne pokreće jer traje cijeli dan nije smoke test.

Gdje je mjesto sandboxu

Ništa od ovoga ne čini sandbox manje korisnim. Čini ga poštenim: mjesto gdje učite shemu i potvrđujete da su zahtjevi ispravni, prije nego što fixtures i žive provjere preuzmu ono do čega on ne doseže. Ako procjenjujete API-je platforme za letove i hotele, pristup počinje razgovorom, a ne ključem za samoposluživanje — donesite ovaj plan testiranja na taj razgovor i pitajte kako bi bio pokriven svaki redak gornje tablice. Odgovori će vam reći više o jednom API-ju nego njegova dokumentacija.

Uredništvo Tekravel

Desk za putničke tehnologije

Desk za putničke tehnologije Tekravela piše za struku: vlasnike agencija, konsolidatore i programere koji ih integriraju. Svaki se članak prije objave provjerava na platformi koju opisuje.