Rufen Sie einen Prozess über die id ab, die Human Plugin beim Erstellen zurückgegeben hat.
GET /v1/processes/{id}
id ist die UUID aus der Antwort auf das Erstellen. Es gibt keinen Authentifizierungs-Header und keine Mandantentrennung: Jeder Aufrufer, der Human Plugin erreichen kann, kann jeden seiner Prozesse lesen.
curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
Wann das Ergebnis vorliegt
- Ein ausstehender Prozess (
PROCESS_STATE_CREATED) wird bei jedem Lesen geprüft und mit seinem Ergebnis beantwortet, sobald eines vorliegt. - Ein abgeschlossener oder fehlgeschlagener Prozess ist endgültig und wird unverändert beantwortet.
- Ein unterbrochenes Erstellen wird etwa 70 Sekunden nach seinem Start als fehlgeschlagen beantwortet.
Das Lesen ist die einzige Möglichkeit, einen ausstehenden Prozess voranzubringen: Es gibt keinen Hintergrundjob, und die Rückkehr zu Ihrer callbackUri aktualisiert Human Plugin nicht.
Antwort
200 OK mit derselben Struktur wie beim Erstellen: id, state und data.
Eine ausstehende Journey:
{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }
Abgeschlossene und fehlgeschlagene Prozesse
Ein abgeschlossener Prozess liefert sein Ergebnis in data: wer die Person ist, in humanToken, und die Intelligence zur Person, in ndocs, sowie liveness, wenn der Flow sie prüft. Eine Revalidierung liefert humanTokenMatch anstelle von humanToken. Jedes Feld ist unter Das Ergebnis in data beschrieben. Ein fehlgeschlagener Prozess liefert PROCESS_STATE_FAILED mit leerem data.
Ein abgeschlossener Prozess:
{
"id": "b063041c-7529-4e70-a2b4-c71c00f19801",
"state": "PROCESS_STATE_FINISHED",
"data": {
"humanToken": { "value": "6d3d71…", "status": "validated" },
"liveness": { "value": "live", "status": "validated" },
"ndocs": {
"distinctClientsCount": 2,
"transactionsCount": 3,
"firstSeen": "2026-09-08",
"lastSeen": "2026-11-03",
"credentials": [
{ "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
]
}
}
}
Eine abgeschlossene Revalidierung, bei der ndocs die von Ihnen bestätigte Person beschreibt:
{
"id": "7f2c9a10-3d4e-4b5f-8a61-0c9e2d7b4a35",
"state": "PROCESS_STATE_FINISHED",
"data": {
"humanTokenMatch": "true",
"liveness": { "value": "live", "status": "validated" },
"ndocs": {
"distinctClientsCount": 2,
"transactionsCount": 4,
"firstSeen": "2026-09-08",
"lastSeen": "2026-11-04",
"credentials": [
{ "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
]
}
}
}
Ein fehlgeschlagener Prozess:
{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }
Das Journey-token und der link werden nur beim Erstellen zurückgegeben. Bewahren Sie sie aus dieser Antwort auf.
Fehler
| Status | message | Bedeutung |
|---|---|---|
| 404 | PROCESS_NOT_FOUND | Die id ist keine UUID oder unbekannt |
| 502 | UPSTREAM_UNAVAILABLE | Der Prozess ist ausstehend und sein Ergebnis konnte nicht geprüft werden. Später erneut versuchen |
| 503 | DATABASE_UNAVAILABLE | Die Datenbank ist ausgefallen. Später erneut versuchen |
Lesezugriffe können gefahrlos wiederholt werden.