Versionierung und OpenAPI

Entwickeln Sie gegen den ausdrücklich versionierten Vertrag /api/v1 und das herunterladbare OpenAPI-Dokument.

API-Version

API-Version: Die URL-Version bezeichnet den öffentlichen API-Vertrag.
Engine-Release: Die Engine-Versionsnummer in OpenAPI bezeichnet die Implementierung, aus der das Dokument exportiert wurde; sie ist nicht die expected_version einer Ressource.
Ressourcenversion: Geschäftliche Ressourcenversionen dienen der Nebenläufigkeitskontrolle und müssen aus aktuellen Antworten stammen.

Bewahren Sie den heruntergeladenen Vertrag mit den Integrationstests auf.
Prüfen Sie beim Aktualisieren Pflichtfelder, erlaubte Enum-Werte und Antwortschemas.