Skip to content

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

  1. 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
  2. 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.
  3. 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)
  4. Optional: Es gibt einen zweiten SSP-/ZSD-Endpunkt GET /v1/destination-ids, über den Destination-IDs aufgelistet werden können.
Edited by Pascal Sochacki