Destination-IDs erstellen
sequenceDiagram
API-Client ->> OAuth: Access Token (enthält "create:destination-id") abrufen
API-Client ->> SSP/Mgt-Backend: Destination-ID anlegen { name: "", submissionHost: "" } (POST)
SSP/Mgt-Backend ->> SSP/Mgt-Backend: UUID generieren
SSP/Mgt-Backend ->> SSP/Mgt-Backend: Destination-ID einem User auf Basis der Client-Zugehörigkeit zuordnen
SSP/Mgt-Backend ->> OAuth: Access Token (enthält "create:destination-id") abrufen
SSP/Mgt-Backend ->> Zustelldienst: Destination-ID anlegen
%% SSP ->> SSP: Zustellpunkt einem Team auf Basis der Client-Zugehörigkeit zuordnen (Berechtigung setzen)
Zustelldienst ->> Zustelldienst: Destination-ID als Datenbankeintrag anlegen
SSP/Mgt-Backend->> OAuth: Scope ("manage:destination:...") + `aud` anlegen
Destination-IDs erstellen
-
Es existiert ein neuer SSP-Endpunkt POST <ssp>/v1/destination-ids
zum Anlegen einer neuen Destination-ID:- Request: { "name": "Test-Zustellpunkt für Fachverfahren XY", submissionHost: "submission-api-testing.fit-connect.fitko.dev" } (
submissionHost
muss dem Hostname des Zustelldienstes entsprechen) - Response: { "destinationId": "620e9e5f-36d6-480a-acbe-25e92072c413" }
- OAuth-Absicherung:
create:destination-id
- Request: { "name": "Test-Zustellpunkt für Fachverfahren XY", submissionHost: "submission-api-testing.fit-connect.fitko.dev" } (
-
Auf Basis der Client-ID im Access Token (Sub Claim) ordnet das SSP die neue Destination-ID dem User zu, der den Client mit dieser Client-ID besitzt. -
Es existiert ein neuer, ebenfalls interner, Submission-API-Endpunkt POST /v1/destination-ids
, über den Destination-IDs im Zustelldienst angelegt werden können. Dabei wird nur die Destination-ID, aber nicht die Destination im Zustelldienst angelegt.- Request: { "destinationID": "" }
- Response:
204 No Content
(ohne Response-Body)
-
Optional: Es gibt einen zweiten SSP-/ZSD-Endpunkt GET /v1/destination-ids
, über den Destination-IDs aufgelistet werden können.
Edited by Pascal Sochacki