Descrieți schimbul
Pentru fiecare operațiune, documentați metoda, resursa, câmpurile necesare și forma unui răspuns de succes. Includeți o eroare de validare. Distingeti între o eșec de transport și o cerere respinsă: lipsa unui răspuns nu dovedește că o operațiune care schimbă starea a eșuat.
Tratați acreditările ca pe o configurație
Păstrați acreditările serverului în afara pachetelor browser și a depozitelor de cod sursă. Solicitați cel mai mic set util de permisiuni și separați accesul de dezvoltare de accesul în producție. Înregistrați cine deține fiecare integrare și cum poate fi accesul revocat. Urmați fluxul de autorizare documentat de furnizor.
Planificați pentru dependențe indisponibile
Setați timpii de expirare, respectați ghidul privind limitarea cererilor și încercați din nou doar atunci când o operațiune este sigură de repetat. Unde este suportat, o cheie de idempotentă poate identifica cererile repetate. Înregistrați un identificator al cererii și o categorie concisă a eșecului; evitați header-ele de autorizare, cookie-urile de sesiune și datele personale din încărcătura cererii.