Aktiven Nutzer suchen

1:N-Gesichtssuche ohne Lebenderkennung — für aktive Nutzer und sitzungsähnliche Abläufe (ein Suchbild).

menu_bookAPI-Referenz: Gesichtssuche 1:N (aktiver Nutzer)expand_more

Offizielle Docs: docs.verifik.co/biometrics/search-active-user (1:N-Suche ohne Lebenderkennung — aktive Nutzer / Sitzungen).

Basis-URL https://api.verifik.co. Ein rohes Base64-Suchbild in image, erforderlich os (ANDROID, IOS oder DESKTOP) sowie min_score und search_mode. Diese Demo nutzt DESKTOP.

POST /v2/face-recognition/search-active-user

Ähnlich der Live-Suche, aber ohne Lebenderkennung — wenn der Nutzer bereits authentifiziert ist oder einer vertrauenswürdigen Sitzung angehört.

Überschrift	Wert
Content-Type	application/json
Authorization	Bearer <token>

Parameter	Erf.	Beschreibung
image	Ja	Einzelnes Base64-Suchbild
os	Ja	ANDROID, IOS oder DESKTOP
min_score	Ja	Abgleichsschwelle (0,5–1,0)
search_mode	Ja	FAST oder ACCURATE
collection_id	Nein	Suche auf eine Sammlung beschränken

await fetch("https://api.verifik.co/v2/face-recognition/search-active-user", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});

Diese Demo nutzt searchActiveUser aus @humanauthn/api-client mit Ihrem Sitzungstoken.
Für Lebenderkennung + 1:N nutzen Sie stattdessen search-live-face (siehe „Face Search 1:N Live“ in der Dokumentation).

menu_book

Offizielle Anleitungen auf docs.verifik.co

Object

The Person Object

Felder und Struktur eines Gesichtserkennungs-Personendatensatzes.

GET

List All Persons

Personen Ihres Mandanten mit optionalen Filtern.

GET

Retrieve a Person

Eine Person nach ID.

PUT