Skip to content

Datahandler ​

Abruf asynchroner Prozess-Ergebnisse. Endpunkte wie cert/setrequest oder contact/extendsearch liefern eine datahandler_ID; das Ergebnis wird über datahandler/get abgeholt (einmalig lesbar).

Asynchrones Ergebnis abrufen ​

POST KUNDEN-HMAC /datahandler/get/{datahandler_ID}

Ruft das Ergebnis eines asynchronen Prozesses ab (z. B. cert/setrequest, contact/extendsearch). Einmalig lesbar: Der Eintrag wird nach erfolgreichem Abruf gelöscht. Solange das Ergebnis noch nicht vorliegt, liefert der Endpunkt 409 – die Abfrage ist zu wiederholen (Polling).

Pfad-Parameter ​

ParameterBeispielBeschreibung
datahandler_ID62c1b7fe-8111-4721-a141-a239c2f4aa49UUID des Datahandler-Eintrags

Response ​

Die hinterlegten Ergebnisdaten (JSON).

Mögliche Fehler ​

CodeMeldungBedingung
404data not foundEintrag unbekannt oder gehört einem anderen Unternehmen
410data expiredEintrag abgelaufen – wurde gelöscht
409data not foundEintrag existiert, aber Ergebnis noch nicht hinterlegt – Polling fortsetzen
406validationinvaliddatahandler_ID ist keine UUID
403access deniedHMAC-Signatur ungültig oder abgelaufen, hmac_unique wiederverwendet oder Origin nicht freigegeben
500–Interner Fehler – generische Meldung
503–Rate-Limit überschritten (250 Requests/s pro IP)

Mit 🌈 entwickelt in Berlin 🐻 & Köln ⛪
Hosting zu 100% in Deutschland 🇩🇪