Person suchen

Gesichtsbilder hochladen, um registrierte Personen nach Ähnlichkeit zu suchen (1:N).

menu_bookAPI-Referenz: Gesichtssuche (1:N)expand_more

Offizielle Docs: docs.verifik.co/biometrics/search (Gesichtssuche — Abgleich per Gesichtsbild mit registrierten Personen).

Basis-URL https://api.verifik.co. Ein oder mehrere rohe Base64-Bilder derselben Person in images senden (ohne data-URL-Präfix). Optional mit collection_id eingrenzen. Die öffentliche Dokumentation empfiehlt 1–3 Bilder für bessere Trefferquote.

POST /v2/face-recognition/search

1:N-Identifikation: liefert Kandidatenpersonen sortiert nach Ähnlichkeitswert.

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

Parameter	Erf.	Beschreibung
images	Ja	Array von Base64-Gesichtsbildern (dieselbe Person; bis ca. 3 empfohlen)
min_score	Ja	Übereinstimmungsschwelle (z. B. 0,2–1,0)
search_mode	Ja	FAST oder ACCURATE
collection_id	Nein	Suche auf eine Sammlung beschränken
max_results	Nein	Obergrenze für Treffer (API-Standard, falls nicht gesetzt)

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

Diese Demo nutzt searchPerson aus @humanauthn/api-client mit Ihrem Sitzungstoken.
Antworten enthalten typischerweise sortierte Treffer und je nach Umgebung einen Signaturblock.

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