Einen Prozess abrufenGET

Rufen Sie einen Prozess über die id ab, die Human Plugin beim Erstellen zurückgegeben hat.

Markdown

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.

Weiter

Das Selfie abrufen