SDKs und Entwicklerwerkzeuge
OpenAPI und API-Referenz
Einen maschinenlesbaren Vertrag für generierte Clients und Entwicklerwerkzeuge pflegen.
Eine einzige Wahrheit
Routenschemas, Beispiele, Authentifizierung und Fehlerobjekte sollten dem öffentlichen OpenAPI-Vertrag entsprechen.
Versionierung
Inkompatible Änderungen erfordern eine neue API-Version oder einen Kompatibilitätsplan.