Human Token

Human Token ist für Szenarien konzipiert, in denen keine Beziehung zu einem staatlich ausgestellten Dokument besteht — Situationen, in denen Kunden aus Datenschutzgründen keine Dokumentennummern teilen möchten. Seine Kernfunktion besteht darin, aus einer einzigen Selfie-Aufnahme eine eindeutige Identität für jedes Gesicht zu erstellen.

Dies ermöglicht Ihnen:

• Wiederkehrende Nutzer erkennen und doppelte Konten verhindern — erkennen Sie, ob dieselbe Person zurückkehrt oder versucht, mehrere Konten zu erstellen, und gewährleisten Sie eine konsistente Identitätserkennung ohne offizielle Dokumente.
• Integration über Web, Nativ oder API — nur das Selfie-Bild als Eingabe, ohne zusätzliche Dokumentendaten.
• Mit anderen Signalen kombinieren — Human Token bei Bedarf neben anderen Capabilities hinzufügen.

Was es tut

Aus dem aufgenommenen Selfie generiert Human Token einen stabilen, opaken biometrischen Bezeichner (personId), der dieses Gesicht eindeutig repräsentiert. Der Benutzer gibt keinen Bezeichner an — die Identität ist das Ergebnis des Aufrufs, nicht die Eingabe. Bei jeder erfolgreichen Übereinstimmung gibt die Antwort dieselbe personId zurück, sodass derselbe Benutzer in zukünftigen Prozessen wiedererkannt werden kann.

Eingaben

Das Selfie wird vom SDK oder der Web Journey aufgenommen. Bei der headless-API-Integration wird das Bild als imagebase64 im Body von POST /processes/v1 gesendet. Fügen Sie subject.code nicht ein — Human Token gibt die personId in der Antwort zurück.

SDK für qualitativ hochwertige Aufnahme erforderlich

Um sicherzustellen, dass das über die API gesendete Bild die biometrischen Anforderungen erfüllt, verwenden Sie das Unico SDK für Ihre Plattform oder folgen Sie dem Aufnahmestandard. Human Token akzeptiert keine beliebigen Bilder ohne Qualitätskontrolle der Aufnahme.

Mögliche Antworten

idFace.result	Bedeutung
FOUND	Identität aufgelöst. personId wird zurückgegeben und befüllt.

Wenn keine personId generiert werden kann

Es gibt ein einziges Szenario, in dem Human Token keine personId erzeugt: Das Gesicht kann im übermittelten Bild nicht identifiziert werden — es wird kein Gesicht erkannt, die Bildqualität ist zu niedrig, oder das Gesicht entspricht nicht dem Aufnahmestandard (geneigt, zur Seite gedreht). Dies ist kein result-Wert: Die Anfrage schlägt fehl mit 20532 — No face detected in image. Die Einhaltung des Aufnahmestandards verhindert dies.

Antwortbeispiel

{
  "id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
  "status": 3,
  "idFace": {
    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "result": "FOUND"
  }
}

personId ist ein stabiler, opaker Bezeichner — derselbe Benutzer wird immer denselben Wert ergeben. Speichern Sie ihn zusammen mit Ihrem Benutzerdatensatz, um dieselbe Person bei nachfolgenden Human Token-Aufrufen wiederzuerkennen.

Verfügbarkeit

Oberfläche	Unterstützt
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅
API (headless, ohne SDK)	✅