Architektur Fortgeschritten
API Versioning Strategien¶
API VersioningRESTAPI Design 3 Min. Lesezeit
Wie man REST APIs versioniert, ohne Clients zu beschädigen. URL-, Header- und Query-Parameter-Versioning.
Ansätze¶
# URL Path (am häufigsten)
GET /api/v1/users/123
GET /api/v2/users/123
# Header
GET /api/users/123
Accept: application/vnd.myapi.v2+json
# Query Parameter
GET /api/users/123?version=2
Breaking vs Non-breaking¶
Breaking: Entfernen eines Feldes, Typänderung, Hinzufügen eines Pflichtparameters.
Non-breaking: Hinzufügen eines optionalen Feldes, neuer Endpoint, neuer optionaler Parameter.
Zusammenfassung¶
Versionieren Sie von Anfang an. Bevorzugen Sie additive Changes. Pflegen Sie die alte Version während einer Übergangszeit.
Brauchen Sie Hilfe bei der Implementierung?¶
Unser Team hat Erfahrung mit dem Entwurf und der Implementierung moderner Architekturen. Wir helfen Ihnen gerne.