Salt la conținut
Blog

Testarea unui API de călătorii în sandbox: ce nu vă arată

Redacția Tekravel
Scris cu ajutorul IA

Integrarea a trecut tot ce a putut arunca asupra ei testarea API-ului de călătorii în sandbox. Căutarea întorcea zboruri, apelul de disponibilitate pentru hoteluri venea cu camere libere, apelul de rezervare dădea de fiecare dată un număr de confirmare, iar QA a semnat într-o joi. Marțea următoare, un client a plătit un hotel la un preț și furnizorul l-a confirmat la altul, o rezervare de zbor a intrat în timeout și nimeni nu putea spune dacă locul fusese blocat, iar un agent de suport și-a petrecut după-amiaza reconciliind două înregistrări care descriau aceeași călătorie. Niciuna nu era un bug scăpat de suita de teste. Erau scenarii pe care suita nu avea cum să le vadă. Sandboxul e necesar, dar e departe de a fi suficient, iar în golul dintre cele două trăiesc cele mai multe incidente scumpe ale unei integrări de turism.

Acesta e un plan de testare pentru dezvoltatorul care deține acea integrare: ce poate dovedi un sandbox, ce nu poate prin însăși natura lui și cum acoperiți diferența fără să rezervați locuri reale pe cardul firmei.

De ce codul care trece în sandbox se strică în producție

Un sandbox e o promisiune despre forma răspunsurilor, nu despre comportamentul lor. Schema coincide cu producția. Comportamentul aproape niciodată, din motive care nu sunt vina nimănui: un mediu de test nu-și permite inventar real, așa că servește un set fix de tarife și camere care nu se epuizează niciodată, nu își schimbă prețul și nu își schimbă orarul. Răspunde repede pentru că nu-l mai folosește nimeni altcineva. Rareori cade la jumătate.

Producția face toate aceste lucruri zilnic. Inventarul e împărțit cu toți ceilalți vânzători; tarifele sunt ținute în cache undeva în amonte și se învechesc; sistemul unui furnizor sub sarcină răspunde încet sau deloc. Codul care a văzut doar un sandbox a fost testat, în fond, doar împotriva unui furnizor într-o zi perfectă.

Tratați deci sandboxul ca pe un strat din trei. El dovedește că cererile sunt bine formate și că parserul înțelege schema. Fixture-urile înregistrate dovedesc că codul supraviețuiește răspunsurilor pe care producția le trimite cu adevărat. Un set mic și deliberat de verificări live dovedește conexiunile după ce ceva se schimbă. Fiecare strat prinde ce nu pot prinde celelalte două.

Scenariile pe care un sandbox de obicei nu vi le dă

Scrieți-le înainte de a scrie primul test. Un sandbox poate simula unul sau două cu o valoare de test magică; pe cele mai multe pur și simplu nu le are.

ScenariuCe face producțiaCum îl acoperiți
Prețul se schimbă între căutare și rezervareRezervarea reușește la alt total sau eșuează cu o eroare de schimbare de preț pe care trebuie s-o afișațiPereche de fixture-uri: un răspuns de căutare și unul de rezervare cu total diferit; verificați că turistul e întrebat din nou, niciodată taxat pe tăcute
Epuizat între disponibilitate și rezervareCamera sau clasa tarifară oferită a dispărut când încercați s-o blocațiFixture cu eroarea reală de epuizare a furnizorului; verificați că turistul revine la rezultate, nu la o pagină de eroare
Timeout la apelul de rezervareFurnizorul poate să fi creat rezervarea sau nuInjectați un timeout după trimiterea cererii; verificați că interogați starea rezervării înainte ca ceva să reîncerce
Trimitere dublăUn dublu clic sau un retry al clientului creează două rezervăriTrimiteți aceeași rezervare de două ori cu același idempotency key; verificați că există exact una
Schimbare de orar după emitereZborul vândut pleacă acum la altă oră sau cu alt număr de zborFixture cu itinerariu modificat; verificați că schimbarea ajunge la cine se ocupă de client
Succes parțial la o rezervare cu mai multe serviciiZborul se confirmă, hotelul nuFixture mixt; verificați că sistemul înregistrează exact ce s-a confirmat și alertează un om
Throttling sub sarcinăRăspunsuri de rate limit, apoi răspunsuri lenteRedați un răspuns de throttling înregistrat; verificați backoff-ul și că o căutare se degradează în loc să dea eroare

Pentru stack-ul vostru poate nu sunteți de acord cu ultima coloană. E în regulă. Contează ca fiecare rând să aibă un responsabil și o aserțiune, pentru că fiecare vi se va întâmpla până la urmă.

Construiți fixture-uri din răspunsuri reale, nu inventate

Cel mai util obicei într-o integrare de turism este să păstrați răspunsurile care v-au surprins. Mock-urile scrise de mână reflectă ce credeți voi că trimite un furnizor; un răspuns înregistrat reflectă ce a trimis de fapt, inclusiv câmpurile goale despre care documentația spune că nu sunt niciodată goale, prețul într-o monedă pe care n-ați cerut-o și eroarea care vine cu status de succes.

O rutină care funcționează:

  • Înregistrați la graniță. Logați corpurile brute de cerere și răspuns ale apelurilor către furnizori într-un mediu care nu e de producție, iar în producție pentru un eșantion din trafic, dacă regulile voastre de confidențialitate permit.
  • Curățați înainte să păstrați. Numele pasagerilor, numerele de pașaport, e-mailurile, telefoanele și referințele de plată ies înainte ca un fixture să intre în repository. Înlocuiți-le cu valori evident false, ca nimeni să nu confunde un fixture cu o rezervare reală.
  • Numiți fixture-urile după comportament. hotel-book-price-increased.json îi spune următorului dezvoltator de ce există; response-17.json nu.
  • Păstrați-le pe cele urâte pentru totdeauna. Răspunsul malformat care a picat căutarea într-o duminică e cel mai valoros fișier pe care îl aveți. Locul lui e într-un test care rulează la fiecare commit.

Apoi scrieți teste de contract pe aceste fixture-uri: parserul, maparea în modelele interne, clasificarea erorilor. Dacă un furnizor redenumește un câmp și un test de contract pică, aflați în CI, nu de la un client. Partea de clasificare e tratată pe larg în articolul nostru despre gestionarea erorilor în API-ul unui motor de rezervări.

Testarea fluxurilor de bani fără să cheltuiți bani

Aici sandboxul ajută cel mai puțin, pentru că fluxurile de bani sunt exact locul unde un mediu de test diferă de cel real. Emiterea reală de bilete, încasarea reală pe card și facturarea reală a furnizorului sunt ce trebuie cel mai mult să iasă bine și ce puteți repeta cel mai puțin live.

Împărțiți problema. Matematica prețurilor e logică pură și poate fi testată exhaustiv offline: luați tarife înregistrate, aplicați regulile de adaos, conversia valutară și rotunjirea, și verificați totalul pe care îl vede turistul. Faceți asta pentru cazurile incomode — un tarif într-o monedă vândut în alta, un adaos procentual la un produs și fix la altul, un tarif pentru copil, o rotunjire care diferă între afișare și încasare. Un total greșit cu câțiva lei rămâne greșit, și e greșit la fiecare rezervare.

Tranzițiile de stare din jurul plății sunt a doua jumătate. Modelați-le explicit — ofertată, blocată, plătită, confirmată, emisă, anulată, rambursată — și testați că fiecare tranziție are exact o cauză. Testul care prinde cel mai scump bug este cel care afirmă că nu se poate încasa o plată pentru o rezervare pe care furnizorul n-a confirmat-o și că o rezervare confirmată nu poate exista fără o înregistrare de plată.

În sfârșit, faceți imposibil ca o rulare de teste să ajungă la emiterea reală. Nu improbabil; imposibil. O verificare la pornire care refuză să ruleze suita când sunt încărcate credențiale de producție costă o linie și previne cea mai proastă dimineață pe care o poate avea o echipă de integrare.

Cât vă costă dacă greșiți

Un scenariu ratat într-o integrare de turism rareori apare ca eroare. Apare ca o rezervare care arată în regulă. Un bilet dublat pe care nu l-a cerut nimeni și pe care cineva trebuie să-l anuleze înainte de termen. Un hotel confirmat la un preț pe care agenția trebuie acum să-l suporte. O rezervare cu timeout pe care sistemul a reîncercat-o, așa că furnizorul ține două camere și le facturează pe amândouă. La un bilet de avion vândut prin agenție, o nepotrivire între ce s-a emis și ce s-a vândut se poate întoarce mai târziu ca ADM, mult după ce marja acelei vânzări a fost cheltuită.

Costurile acestea cad pe firma care a vândut călătoria, nu pe dezvoltatorul care a scris bucla de retry. Ăsta e tot argumentul pentru a le testa înainte de lansare, în loc să le învățați câte un tichet de suport pe rând.

Ce verificați după fiecare schimbare la furnizor

Furnizorii schimbă lucruri: o versiune nouă de API, un endpoint nou, o credențială rotită, o mapare diferită a conținutului. Codul vostru poate să nu se fi schimbat deloc. Rulați lista oricum, în mediul care vorbește cu furnizorul modificat:

  1. O căutare pentru fiecare produs pe care îl vindeți de la acel furnizor, pe o rută sau un oraș despre care știți că întoarce rezultate.
  2. Parsați fiecare rezultat fără să pierdeți vreunul pe tăcute; comparați numărul vostru cu ce conține răspunsul brut.
  3. Calculați prețul unui rezultat de la cap la coadă și comparați totalul afișat cu propriul calcul pornind de la tariful brut.
  4. Faceți o rezervare în mediul de test, citiți-i starea înapoi și comparați fiecare câmp pe care îl stocați.
  5. Anulați-o și confirmați că anularea se vede atât în înregistrările voastre, cât și la furnizor.
  6. Treceți fixture-urile urâte salvate prin noul parser.
  7. Verificați că timeout-urile și rate limit-urile duc încă la comportamentul hotărât, pentru că o versiune nouă poate răspunde altfel. Dacă timpii de răspuns s-au mutat, articolul despre latență explică ce parte vă revine vouă să reparați.

Destul de scurtă ca s-o rulați de fiecare dată, și asta e ideea. Un smoke test pe care nu-l rulează nimeni pentru că durează o zi nu e un smoke test.

Unde își are locul sandboxul

Nimic din toate acestea nu face sandboxul mai puțin util. Îl face onest: locul unde învățați schema și confirmați că cererile sunt corecte, înainte ca fixture-urile și verificările live să preia părțile la care el nu ajunge. Dacă evaluați API-urile de zboruri și hoteluri ale platformei, accesul începe cu o discuție, nu cu o cheie self-service — aduceți acest plan de testare la acea discuție și întrebați cum ar fi acoperit fiecare rând din tabelul de mai sus. Răspunsurile vă vor spune despre un API mai mult decât documentația lui.

Redacția Tekravel

Departamentul de tehnologii de turism

Departamentul de tehnologii de turism al Tekravel scrie pentru industrie: proprietari de agenții, consolidatori și dezvoltatorii care îi integrează. Fiecare articol este verificat pe platforma pe care o descrie înainte de publicare.