Vai al contenuto
Blog

Test di API viaggi in sandbox: cosa la sandbox non vi mostra

Redazione Tekravel
Scritto con l'aiuto dell'IA

L'integrazione aveva superato tutto ciò che i test della API viaggi in sandbox potevano lanciarle contro. La ricerca restituiva voli, la chiamata di disponibilità hotel tornava con camere libere, la chiamata di prenotazione rispondeva ogni volta con un numero di conferma e il QA aveva dato l'ok un giovedì. Il martedì successivo un cliente ha pagato un hotel a un prezzo e il fornitore l'ha confermato a un altro, una prenotazione aerea è andata in timeout senza che nessuno sapesse dire se il posto fosse bloccato, e un operatore dell'assistenza ha passato un pomeriggio a riconciliare due record che descrivevano lo stesso viaggio. Nessuno di questi era un bug sfuggito alla suite di test. Erano scenari che la suite non aveva alcun modo di vedere. La sandbox è necessaria, ma è lontanissima dall'essere sufficiente, e nello spazio fra le due cose vivono quasi tutti gli incidenti costosi di un'integrazione di viaggio.

Questo è un piano di test per lo sviluppatore che possiede quell'integrazione: cosa una sandbox può dimostrare, cosa per sua natura non può, e come coprire la differenza senza prenotare posti veri con la carta aziendale.

Perché il codice che passa i test in sandbox si rompe in produzione

Una sandbox è una promessa sulla forma delle risposte, non sul loro comportamento. Lo schema coincide con la produzione. Il comportamento quasi mai, per ragioni che non sono colpa di nessuno: un ambiente di test non può permettersi di far girare inventario reale, quindi serve un insieme fisso di tariffe e camere che non si esauriscono mai, non cambiano prezzo e non cambiano orario. Risponde in fretta perché nessun altro lo sta usando. Raramente fallisce a metà.

La produzione fa tutte queste cose ogni giorno. L'inventario è condiviso con tutti gli altri venditori; le tariffe vengono messe in cache da qualcuno a monte e invecchiano; il sistema di un fornitore sotto carico risponde lentamente o non risponde affatto. Un codice che ha visto solo una sandbox, in pratica, è stato testato soltanto contro un fornitore in una giornata perfetta.

Trattate quindi la sandbox come uno di tre livelli. Dimostra che le richieste sono ben formate e che il parser capisce lo schema. Le fixture registrate dimostrano che il codice sopravvive alle risposte che la produzione invia davvero. Un piccolo insieme deliberato di verifiche live dimostra che i collegamenti reggono dopo un cambiamento. Ogni livello intercetta ciò che gli altri due non vedono.

Gli scenari che una sandbox di solito non vi dà

Scriveteli prima di scrivere un solo test. Una sandbox può simularne uno o due con un valore di test speciale; la maggior parte semplicemente non ce l'ha.

ScenarioCosa fa la produzioneCome coprirlo
Il prezzo cambia tra ricerca e prenotazioneLa prenotazione riesce con un totale diverso, oppure fallisce con un errore di cambio prezzo da mostrare all'utenteCoppia di fixture: una risposta di ricerca e una di prenotazione con totale diverso; verificare che il viaggiatore venga interpellato di nuovo, mai addebitato in silenzio
Esaurito tra disponibilità e prenotazioneLa camera o la classe tariffaria offerta non c'è più quando provate a bloccarlaFixture del vero errore di esaurito del fornitore; verificare che il viaggiatore torni ai risultati, non a una pagina di errore
Timeout sulla chiamata di prenotazioneIl fornitore può aver creato la prenotazione oppure noIniettare un timeout dopo l'invio della richiesta; verificare che si interroghi lo stato della prenotazione prima di qualunque nuovo tentativo
Invio duplicatoUn doppio clic o un retry del client crea due prenotazioniInviare la stessa prenotazione due volte con la stessa idempotency key; verificare che ne esista esattamente una
Cambio di orario dopo l'emissioneIl volo venduto ora parte a un altro orario, o con un altro numero di voloFixture di un itinerario modificato; verificare che la modifica arrivi a chi gestisce il cliente
Successo parziale su una prenotazione multi-servizioIl volo si conferma, l'hotel noFixture mista; verificare che il sistema registri esattamente ciò che è stato confermato e avvisi una persona
Throttling sotto caricoRisposte di rate limit, poi risposte lenteRiprodurre una risposta di throttling registrata; verificare il backoff e che la ricerca si degradi invece di andare in errore

Per il vostro stack potreste non essere d'accordo con l'ultima colonna. Va bene. Conta che ogni riga abbia un responsabile e un'asserzione, perché prima o poi ognuna vi capiterà.

Costruite le fixture da risposte reali, non inventate

L'abitudine più utile in un'integrazione di viaggio è conservare le risposte che vi hanno sorpreso. I mock scritti a mano riflettono ciò che pensate un fornitore invii; una risposta registrata riflette ciò che ha inviato davvero, compresi i campi vuoti che secondo la documentazione non lo sono mai, il prezzo in una valuta che non avevate chiesto e l'errore che arriva con uno stato di successo.

Una routine che funziona:

  • Registrate al confine. Loggate i corpi grezzi di richiesta e risposta delle chiamate ai fornitori in un ambiente non di produzione, e in produzione per una quota campionata del traffico se le vostre regole sulla privacy lo consentono.
  • Ripulite prima di conservare. Nomi dei passeggeri, numeri di passaporto, email, telefoni e riferimenti di pagamento escono prima che una fixture entri nel repository. Sostituiteli con valori palesemente finti, così nessuno scambia una fixture per una prenotazione reale.
  • Date alle fixture il nome del comportamento. hotel-book-price-increased.json dice al prossimo sviluppatore perché esiste; response-17.json no.
  • Tenete per sempre quelle brutte. La risposta malformata che una domenica ha mandato giù la ricerca è il file più prezioso che avete. Il suo posto è in un test che gira a ogni commit.

Poi scrivete contract test su quelle fixture: il parser, la mappatura nei modelli interni, la classificazione degli errori. Se un fornitore rinomina un campo e un contract test fallisce, lo scoprite in CI e non da un cliente. La parte sulla classificazione è approfondita nel nostro articolo sulla gestione degli errori nella API di un motore di prenotazione.

Testare i flussi di denaro senza spendere denaro

Qui la sandbox aiuta meno che altrove, perché i flussi di denaro sono proprio il punto in cui un ambiente di test differisce da quello reale. L'emissione vera dei biglietti, l'incasso vero sulla carta e la fatturazione vera del fornitore sono ciò che più dovete fare bene e che meno potete provare dal vivo.

Dividete il problema. La matematica dei prezzi è logica pura e si può testare in modo esaustivo offline: prendete tariffe registrate, applicate le regole di markup, la conversione valutaria e gli arrotondamenti, e verificate il totale che vede il viaggiatore. Fatelo per i casi scomodi: una tariffa in una valuta venduta in un'altra, un markup percentuale su un prodotto e fisso su un altro, una tariffa bambino, un arrotondamento che differisce tra visualizzazione e addebito. Un totale sbagliato di pochi euro resta sbagliato, ed è sbagliato su ogni prenotazione.

Le transizioni di stato attorno al pagamento sono la seconda metà. Modellatele in modo esplicito — quotata, bloccata, pagata, confermata, emessa, cancellata, rimborsata — e verificate che ogni transizione abbia esattamente una causa. Il test che cattura il bug più costoso è quello che afferma che non si può incassare un pagamento per una prenotazione che il fornitore non ha confermato, e che non può esistere una prenotazione confermata senza un record di pagamento.

Infine, rendete impossibile che un'esecuzione dei test raggiunga l'emissione reale. Non improbabile: impossibile. Un controllo all'avvio che rifiuta di eseguire la suite quando sono caricate credenziali di produzione costa una riga ed evita la mattina peggiore che un team di integrazione possa vivere.

Quanto costa sbagliare

Uno scenario mancato in un'integrazione di viaggio raramente si presenta come un errore. Si presenta come una prenotazione che sembra a posto. Un biglietto duplicato che nessuno ha chiesto, da annullare prima della scadenza. Un hotel confermato a un prezzo che ora l'agenzia deve assorbire. Una prenotazione in timeout che il sistema ha ritentato, così il fornitore blocca due camere e le fattura entrambe. Per un biglietto aereo venduto tramite agenzia, una discrepanza tra ciò che è stato emesso e ciò che è stato venduto può tornare indietro come ADM, molto dopo che il margine di quella vendita è stato speso.

Questi costi ricadono sull'azienda che ha venduto il viaggio, non sullo sviluppatore che ha scritto il ciclo di retry. È tutto l'argomento per testarli prima del lancio invece di impararli un ticket di assistenza alla volta.

Cosa verificare dopo ogni cambiamento del fornitore

I fornitori cambiano le cose: una nuova versione della API, un nuovo endpoint, una credenziale ruotata, una mappatura dei contenuti diversa. Il vostro codice può non essere cambiato affatto. Eseguite comunque questa lista, nell'ambiente che parla con il fornitore modificato:

  1. Una ricerca per ogni prodotto che vendete da quel fornitore, su una tratta o una città che sapete restituire risultati.
  2. Analizzate ogni risultato senza scartarne nessuno in silenzio; confrontate il vostro conteggio con quello della risposta grezza.
  3. Prezzate un risultato dall'inizio alla fine e confrontate il totale mostrato con il vostro calcolo partendo dalla tariffa grezza.
  4. Fate una prenotazione nell'ambiente di test, rileggetene lo stato e confrontate ogni campo che salvate.
  5. Cancellatela e verificate che la cancellazione sia visibile sia nei vostri record sia dal lato del fornitore.
  6. Fate passare le vostre fixture brutte salvate attraverso il nuovo parser.
  7. Controllate che timeout e rate limit portino ancora al comportamento deciso, perché una nuova versione potrebbe rispondere diversamente. Se i tempi di risposta si sono spostati, l'articolo sulla latenza spiega quale parte tocca a voi correggere.

Abbastanza breve da eseguirla ogni volta, ed è proprio questo il punto. Uno smoke test che nessuno esegue perché richiede una giornata non è uno smoke test.

Il posto giusto della sandbox

Niente di tutto questo rende la sandbox meno utile. La rende onesta: il luogo in cui imparate lo schema e confermate che le richieste sono corrette, prima che fixture e verifiche live prendano in carico le parti che non raggiunge. Se state valutando le API voli e hotel della piattaforma, l'accesso inizia con una conversazione e non con una chiave self-service: portate questo piano di test a quella conversazione e chiedete come verrebbe coperta ogni riga della tabella qui sopra. Le risposte vi diranno di una API più della sua documentazione.

Redazione Tekravel

Desk tecnologie per il turismo

Il desk tecnologie per il turismo di Tekravel scrive per gli operatori: titolari di agenzie, consolidatori e gli sviluppatori che li integrano. Ogni articolo viene verificato sulla piattaforma che descrive prima della pubblicazione.