Skip to content
Snippets Groups Projects
README.md 1.01 KiB
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
- Wir verwenden OpenAPI 3.0
- Die Spezifikation wird bis zur `beta7` als JSON und ab `beta8` als YAML geschreiben
- Wir verwenden keine Versionsnummern in Dateinamen, da das Repo als Ganzes versioniert wird

## Verzeichnisse
Das Projektverzeichnis ist wie folgt aufgebaut:

- 📁`assets`
  - 📁`images` - Bilder
  - 📁`postman` - Postman-Collection und -Enviroment dazu
- 📁`docs` - Öffentliche Dokumentation zu den APIs
- 📁`models` - Modelle, die von mehreren (beiden) APIs verwendet werden
- 📁`reference` - Die APIs
- 📄`LICENSE`

## Bezeichner
- Die Bezeichner werden camelCase geschreiben und beginnen mit einem Kleinbuchstaben
- Eine ID (Identifikator) wird als `Id` (nicht `ID`) geschrieben

## Pfade
Multiple Resoucen werden im Pfad durch eine Collection-Resource und einer nachfolgenden ID aufgenommen

Beispiel: `/destinations/{destinationId}/applications/{applicationId}`