Person anlegen

Neue Person mit Gesichtsbildern und Metadaten registrieren.

menu_bookAPI-Referenz: Person anlegenexpand_more

Offizielle Docs: docs.verifik.co/resources/create-a-person

Basis-URL https://api.verifik.co. JSON mit Profilfeldern und mindestens einem Base64-Gesichtsbild pro Eintrag in images senden (ohne data-URL-Präfix). Die öffentliche Dokumentation nennt weitere optionale Felder wie notes, email und phone.

POST /v2/face-recognition/persons

Registriert eine neue Person in den angegebenen Sammlungs-IDs (collection _id) mit Gesichtsbiometrie für Verifik-basierte Erkennung.

Ü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 (in dieser Demo erforderlich)
date_of_birth	Ja	YYYY-MM-DD (in dieser Demo erforderlich)
collections	Ja	Array von Sammlungs-_id-Strings; diese Demo lädt sie von GET /v2/face-recognition/collections und erlaubt eine oder mehrere Auswahl.
nationality	Nein	Optionales Land / Staatsangehörigkeitscode oder -bezeichnung

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

// 200 OK — example shape
{
  "data": {
    "id": "…",
    "name": "Jane Doe",
    "gender": "F",
    "date_of_birth": "1990-01-15",
    "collections": ["…"],
    "…": "…"
  }
}

Diese Demo nutzt createPerson aus @humanauthn/api-client mit Ihrem Sitzungstoken.
Antworten können je nach Umgebung eine ID und 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