Skip to content
Snippets Groups Projects
README.md 760 B
Newer Older
Marco Holz's avatar
Marco Holz committed
# FIT-Connect API-Spezifikation

Für die Spezifikation der FIT-Connect-Schnittstellen gelten die folgenden Architekturregeln.

## OpenAPI
Marco Holz's avatar
Marco Holz committed
- Wir verwenden OpenAPI 3.0
- Die Spezifikation ist als YAML geschrieben
Marco Holz's avatar
Marco Holz committed
- Wir verwenden keine Versionsnummern in Dateinamen, da das Repo als Ganzes versioniert wird
- Die Spezifikation wird mit Semantic-Versioning versioniert

Marco Holz's avatar
Marco Holz committed
## Bezeichner
- Die Bezeichner werden camelCase geschrieben und beginnen mit einem Kleinbuchstaben
- Eine ID (Identifikator) wird als `Id` nicht `ID` geschrieben
Marco Holz's avatar
Marco Holz committed

## Pfade
Multiple Ressourcen werden im Pfad durch eine Collection-Resource und einer nachfolgenden ID aufgenommen
Marco Holz's avatar
Marco Holz committed

Beispiel: `/v1/submissions/{submissionId}`
## Tag API version
Run and follow the instructions:

    sh tag.sh