IdFace generiert einen eindeutigen Bezeichner aus einem Selfie. Der Benutzer tippt oder gibt einen Bezeichner auf andere Weise nicht an — die Identität ist das Ergebnis des Aufrufs, nicht die Eingabe. Bei einer erfolgreichen Übereinstimmung gibt die Antwort eine stabile, opake person_id zurück, die den Benutzer prozessübergreifend eindeutig identifiziert.
Was es tut
Aus dem aufgenommenen Selfie generiert IdFace einen stabilen, opaken biometrischen Bezeichner (person_id), 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 person_id 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 /v1/process mit flow=idface gesendet. Fügen Sie subject.code nicht ein — IdFace gibt die person_id in der Antwort zurück.
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. IdFace akzeptiert keine beliebigen Bilder ohne Qualitätskontrolle der Aufnahme.
Mögliche Antworten
idFace.result | Bedeutung |
|---|---|
FOUND | Identität bestätigt. person_id wird zurückgegeben und befüllt. |
NOT_FOUND | Identität nicht bestätigt. person_id fehlt in der Antwort. |
Antwortbeispiel
{
"id": "1c1fc38b-7e98-4f9a-a04d-7a4a8b29d2c1",
"status": 3,
"idFace": {
"person_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",
"result": "FOUND"
}
}
person_id ist ein stabiler, opaker Bezeichner — derselbe Benutzer wird immer denselben Wert ergeben. Speichern Sie ihn zusammen mit Ihrem Benutzerdatensatz, um dieselbe Person bei nachfolgenden IdFace-Aufrufen wiederzuerkennen.
Verfügbarkeit
| Oberfläche | Unterstützt |
|---|---|
| SDK (Android, iOS, Flutter) | ✅ |
| Web (iFrame, Redirect) | ✅ |
| API (headless, ohne SDK) | ✅ |