1.0.0 und verwendet OpenAPI 3.1.0.
Die aktualisierten Order- und Division-Schemas werden innerhalb der API-Version
1.0.0 dokumentiert. Die produktive Basis-URL bleibt https://api.jobhandy.io/v1; ein /v2-Endpoint oder eine separate Spezifikationsrevision wird nicht eingeführt.Änderungsklassifizierung
Regeln für Client-Design
- Verwenden Sie keine strikte Response-Deserialisierung, die unbekannte Eigenschaften ablehnt.
- Gehen Sie nicht davon aus, dass eine Enum-Liste niemals erweitert wird.
- Senden Sie ausschließlich dokumentierte Request-Eigenschaften, da Request-Schemas geschlossen sind.
- Pinnen und archivieren Sie die OpenAPI-Datei, mit der der Client erzeugt oder validiert wurde.
- Vergleichen Sie jeden neuen Vertrag vor dem Deployment mit der gepinnten Version.
- Prüfen Sie den Changelog auf Migrationshinweise.