Darstellung
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
| Parameter | Beispiel | Beschreibung |
|---|---|---|
datahandler_ID | 62c1b7fe-8111-4721-a141-a239c2f4aa49 | UUID des Datahandler-Eintrags |
Response
Die hinterlegten Ergebnisdaten (JSON).
Mögliche Fehler
| Code | Meldung | Bedingung |
|---|---|---|
404 | data not found | Eintrag unbekannt oder gehört einem anderen Unternehmen |
410 | data expired | Eintrag abgelaufen – wurde gelöscht |
409 | data not found | Eintrag existiert, aber Ergebnis noch nicht hinterlegt – Polling fortsetzen |
406 | validationinvalid | datahandler_ID ist keine UUID |
403 | access denied | HMAC-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) |