Descrivi lo scambio
Per ciascuna operazione, documenta il metodo, la risorsa, i campi richiesti e la forma di una risposta di successo. Includi un errore di validazione. Distingui un guasto del trasporto da una richiesta rifiutata: la mancanza di una risposta non dimostra che un'operazione che cambia stato sia fallita.
Tratta le credenziali come configurazione
Mantieni le credenziali del server fuori dai pacchetti del browser e dai repository di codice sorgente. Richiedi il set minimo di permessi utile e separa l'accesso allo sviluppo dall'accesso alla produzione. Registra chi possiede ogni integrazione e come può essere revocato l'accesso. Segui il flusso di autorizzazione documentato dal provider.
Pianifica per dipendenze non disponibili
Imposta i timeout, rispetta le linee guida sul rate-limit e riprova solo quando un'operazione è sicura da ripetere. Dove supportato, una chiave di idempotenza può identificare richieste ripetute. Registra un identificatore della richiesta e una categoria di errore concisa; evita intestazioni di autorizzazione, cookie di sessione e dati personali.