Beskriv utbytet
För varje operation, dokumentera metoden, resursen, obligatoriska fält och formen på ett lyckat svar. Inkludera ett valideringsfel. Skilj mellan transportfel och avvisad begäran: ett saknat svar bevisar inte att en tillståndsförändrande operation misslyckades.
Behandla referenser som konfigurering
Håll serverreferenser utanför webbläsarpaket och källkodsförråd. Begär den minsta användbara behörighetsuppsättningen och separera utvecklingsåtkomst från produktionsåtkomst. Dokumentera vem som äger varje integration och hur åtkomst kan återkallas. Följ leverantörens dokumenterade auktoriseringsflöde.
Planera för otillgängliga beroenden
Ställ in timeout, respektera riktlinjer för hastighetsbegränsning och försök endast igen när en åtgärd kan upprepas säkert. Där det stöds kan en idempotensnyckel identifiera upprepade förfrågningar. Logga ett förfrågnings-ID och en kortfattad felkategori; undvik auktoriseringshuvuden, sessionscookies och personlig data.