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.

changed the description

changed the description

added 1 deleted label

marked this issue as related to #61 (closed)

marked this issue as related to #62 (closed)

assigned to @Lilith_Wittmann

Nur https Callbacks, kein Payload darüber schicken, der nicht Statusbezug… nur erlaubtes subset von schemas… Verhindern von fake callbacks über shared secrets… replay attacks…

added 1 deleted label

marked this issue as related to docs#11 (moved)

changed the description

unassigned @Lilith_Wittmann

added 1 deleted label

changed title from Callback innerhalb der API spezifizieren (Gemäß OpenAPI) to Spezifikation Subscriber-Callback

changed the description

added 1 deleted label

added workflow::In Progress label and removed 1 deleted label

assigned to @Marco_Holz

mentioned in merge request !98 (merged)

marked the checklist item Die Sicherheitsvorgaben aus https://git.fitko.de/fit-connect/api/-/issues/62 werden umgesetzt. as completed

marked the checklist item Das Callback wird im POST /destinations-Endpunkt dargestellt. as completed

marked the checklist item Das Callback wird im PATCH /destinations/{destinationId}-Endpunkt dargestellt. as completed

marked the checklist item Das Callback wird im PUT /destinations/{destinationId}-Endpunkt dargestellt. as completed

added workflow::Peer Review label and removed workflow::In Progress label

added 1 deleted label

removed 1 deleted label

mentioned in commit 692e9e8d

closed with merge request !98 (merged)

changed milestone to %Submission API V1.0