Beskriv udvekslingen
For hver operation skal du dokumentere metoden, ressourcen, de krævede felter og formen på et succesfuldt svar. Inkluder en valideringsfejl. Skel mellem en transportfejl og en afvist anmodning: et manglende svar beviser ikke, at en tilstandsændrende operation mislykkedes.
Behandl legitimationsoplysninger som konfiguration
Hold serverlegitimationsoplysninger uden for browserpakker og kildekodemagasiner. Anmod om det mindste nyttige sæt af tilladelser og adskil udviklingstilgang fra produktionstilgang. Registrer, hvem der ejer hver integration, og hvordan adgang kan tilbagekaldes. Følg leverandørens dokumenterede autorisationsflow.
Planlæg for utilgængelige afhængigheder
Sæt timeouts, overhold vejledningen for ratebegrænsning, og prøv kun igen, når en handling er sikker at gentage. Hvor det er understøttet, kan en idempotensnøgle identificere gentagne forespørgsler. Log en forespørgselsidentifikator og en kort fejlkategori; undgå autorisationsheaders, sessioncookies og personlige data.