Person mit Lebenderkennung anlegen

Registrierung, Lebenderkennung und Dublettensuche in einem Aufruf.

menu_bookAPI-Referenz: Person mit Lebenderkennung anlegenexpand_more

Offizielle Docs (Englisch): docs.verifik.co/resources/create-a-person-with-liveness

Dokumentation (Spanisch): docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida

Basis-URL https://api.verifik.co. JSON mit Profilfeldern, einer einzelnen collection_id (collection _id), Schwellenwerten für Lebenderkennung und Suche sowie mindestens einem Base64-Gesichtsbild pro Eintrag in images (ohne data-URL-Präfix).

POST /v2/face-recognition/persons/search-live-face

Führt Lebenderkennung auf den übermittelten Gesichtern aus, sucht nach ähnlichen Registrierungen und legt die Person in der Zielsammlung an oder aktualisiert sie.

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

Parameter	Erf.	Beschreibung
name	Ja	Anzeigename
images	Ja	Array von Base64-Gesichtsbildern (rohes Base64, keine Data-URLs)
gender	Ja	M oder F
date_of_birth	Ja	YYYY-MM-DD
collection_id	Ja	Eine eindeutige Sammlungs-ID
liveness_min_score	Ja	0,5–1
min_score	Ja	Interner Suchschwellenwert, 0,5–1
search_mode	Ja	FAST oder ACCURATE
nationality	Nein	Optional

await fetch("https://api.verifik.co/v2/face-recognition/persons/search-live-face", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    name: "Jane Doe",
    gender: "F",
    date_of_birth: "1990-01-15",
    collection_id: "<collectionMongoId>",
    liveness_min_score: 0.65,
    min_score: 0.8,
    search_mode: "FAST",
    nationality: "CO",
    images: ["<base64>", "<base64>"],
  }),
});

Diese Demo nutzt createPersonWithLiveness aus @humanauthn/api-client mit Ihrem Sitzungstoken.
Antworten können je nach Umgebung einen Signaturblock neben data enthalten.

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