Doku: Self-Service API GET - destinations [Open Code #47, #46, #45, #44, #43]

User Story

1. OpenCode-Anfrage (https://gitlab.opencode.de/fitko/feedback/-/issues/47): "Der Rückgabewert des Endpunktes GET /destinations stimmt nicht mit der Schema-Beschreibung in der Dokumentation überein (https://docs.fitko.de/fit-connect/docs/apis/self-service-api#get-/v1/destinations). Was ist korrekt?"
   • wir passen die Doku an: @yves_adler kommentiert das neue Schema
2. OpenCode-Anfrage (https://gitlab.opencode.de/fitko/feedback/-/issues/46): "Im Self-Service-Portal wird die Adresse in die Felder "street", "zipCode" und "city" aufgeteilt, Über die Self-Service API steht nur "address" zur Verfügung. Wird das Feld wie im Beispiel belegt (https://docs.fitko.de/fit-connect/docs/apis/self-service-api#post-/v1/destinations) erfolgt die Anzeige im Self-Service-Portal nicht korrekt."
3. OpenCode-Anfrage (https://gitlab.opencode.de/fitko/feedback/-/issues/45): "Ein Anlegen eines neuen Zustellpunktes per POST ist ohne Angabe von "encryptionKid" möglich. Ist dies korrekt?"
   • Bug: Feld wird als Pflichfeld in der Self-Service-API und Submission-API eingerichtet (breaking Change der Implementierung, jedoch da abweichend zu der offiziellen Doku als Bugfix in der Versionierung)
4. OpenCode-Anfrage (https://gitlab.opencode.de/fitko/feedback/-/issues/44): "Beim Abrufen eines Zustellpunktes über die Self-Service API soll laut Beispiel in der Dokumentation das Feld "name" vorhanden sein. Dieses Feld fehlt und wird nicht übermittelt. Es wird ein Feld "note" übermittelt, welches in der Dokumentation nicht vorhanden ist."
   • Bug: Ist zwar in der Implementierung falsch, jedoch Fixen wir es in der Self-Service API in der Doku. In der Destination-API wird es als name auftauchen (Bugfix Doku für die Versionierung)
5. OpenCode-Anfrage (https://gitlab.opencode.de/fitko/feedback/-/issues/43): "Beim Anlegen eines neuen Zustellpunktes kann laut Beispiel in Dokumentation (https://docs.fitko.de/fit-connect/docs/apis/self-service-api#post-/v1/destinations) das Feld "replyChannel" gesetzt werden. In der Schema-Beschreibung fehlt jedoch die Dokumenation. Wie genau wird dieses Feld übertragen?"
   • In der Self-Service API soll replyChannel nicht übergeben werden. Das wird erst bei der Umstellung auf die Destination-API korrigiert

@Laura_Elges: Grundsätzlich bitte an den Nutzer die Empfehlung aussprechen, nicht die Self-Service-API zu implementieren, sondern ein paar Wochen abzuwarten, bis die Destination-API bereitgestellt wird. Diese wird sich an den "Internal" Endpunkten stärker orientieren.

Why

Links, Notes, Remarks

Acceptance criteria

1. Doku ist angepasst
2. ...
3. ...

Implementation plan (to be completed by the developer)

• ...
• ...
• ...
• Definition of Done was checked.