Ressourcen statt Aktionen in URLs
REST nutzt Ressourcen (z. B. /orders/{id}) und HTTP-Methoden. Klare Statuscodes (400 fuer Validierung, 409 fuer Konflikte) sparen Support-Zeit. OpenAPI beschreibt Schema und Beispiele - generierte Clients reduzieren Integrationsfehler.
Versionierung
Header-Versionierung oder Pfad (/v1/) sind gaengig. Breaking Changes nur mit Migrationsfenster - in Partner-APIs planen wir 90-180 Tage Parallelbetrieb, dokumentiert im Changelog.
Qualitaet: Contract-Tests gegen Consumer-Expectations (Pact oder aehnlich) verhindern Ueberraschungen bei Deployments.
Backend-Leistung: API & Backend Standorte.