Spezifikation Subscriber-Callback

Zur Benachrichtigung bei neuen Nachrichten und Statusänderungen sind nötige Anpassungen der Schnittstellenspezifikation zur Umsetzung von Push-Notifications (Callback/Webhook) zu erarbeiten, und deren vorgesehene Nutzungsmöglichkeiten zu dokumentieren (docs#11 (moved)). Hierzu soll die Spezifikation des Subscriber-Callback innerhalb der API gemäß OpenAPI erfolgen.

Ziel: Alle Callbacks sollen in der API spezifiziert werden, siehe https://swagger.io/docs/specification/callbacks/. Bisher ist der Callback als Pseudo API dokumentiert.

Akzeptanzkriterien

• Die Sicherheitsvorgaben aus https://git.fitko.de/fit-connect/api/-/issues/62 werden umgesetzt.
• Das Callback wird im POST /destinations-Endpunkt dargestellt.
• Das Callback wird im PUT /destinations/{destinationId}-Endpunkt dargestellt.
• Das Callback wird im PATCH /destinations/{destinationId}-Endpunkt dargestellt.