Configurazione separata dal codice
Mantieni l'indirizzo API e le credenziali all'esterno del codice sorgente. Utilizza variabili di ambiente del server e non pubblicare mai una chiave reale in un bundle del browser. Questa integrazione demo utilizza solo dati di esempio.
Definire il contratto prima di connettersi
Concordare con il team API i campi delle attività, i possibili stati e i formati degli errori. Un contratto condiviso riduce le rilavorazioni ed evita comportamenti impliciti tra dashboard e servizio.
Pianificare il ciclo di vita della richiesta
Imposta i timeout per la creazione delle attività e il recupero dei risultati. Per l'elaborazione asincrona, eseguire il polling a intervalli definiti con un limite di tentativi. La domanda deve esplicitamente cessare di attendere allo scadere del termine.
Trattare gli errori come parte del prodotto
Credenziali non valide, saldo insufficiente e interruzioni necessitano di risposte specifiche. Mostra messaggi utili e registra solo le informazioni necessarie per la diagnosi, senza credenziali o token di soluzione.
Verificare prima del rilascio
Testare errori di autenticazione, limiti di utilizzo e risposte impreviste nello staging. Questa documentazione propone l'organizzazione degli endpoint; il servizio vero e proprio verrà collegato dopo la definizione del contratto.
