Beschrijf de uitwisseling
Voor elke bewerking documenteert u de methode, bron, vereiste velden en de vorm van een succesvolle respons. Voeg een validatiefout toe. Onderscheid een transportfout van een afgewezen verzoek: een ontbrekende respons bewijst niet dat een statusveranderende bewerking is mislukt.
Behandel referenties als configuratie
Houd serverreferenties buiten browserbundels en bronrepositories. Vraag de kleinste nuttige machtiging en scheid ontwikkeltoegang van productietoegang. Noteer wie eigenaar is van elke integratie en hoe toegang kan worden ingetrokken. Volg de gedocumenteerde autorisatiestroom van de aanbieder.
Plan voor onbeschikbare afhankelijkheden
Stel time-outs in, respecteer richtlijnen voor snelheidsbeperkingen en probeer het alleen opnieuw wanneer een bewerking veilig herhaald kan worden. Waar ondersteund, kan een idempotentiesleutel herhaalde verzoeken identificeren. Log een verzoek-ID en een beknopte foutcategorie; vermijd autorisatieheaders, sessiecookies en persoonlijke gegevens.