Créer une personne avec vivacité
Enrôlement + contrôle de vivacité + recherche de doublons en un seul appel.
menu_bookRéférence API : créer une personne avec vivacitéexpand_more
Documentation (anglais) : docs.verifik.co/resources/create-a-person-with-liveness
Documentation (espagnol) : docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida
URL de base https://api.verifik.co. Envoyez du JSON avec les champs de profil, un seul collection_id (_id de collection), les seuils de vivacité et de correspondance, et au moins une image faciale en base64 par entrée dans images (sans préfixe data URL).
POST /v2/face-recognition/persons/search-live-face
Exécute la vivacité sur le(s) visage(s) envoyé(s), recherche les enrôlements similaires et crée ou met à jour une personne dans la collection cible.
| En-tête | Valeur |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req. | Description |
|---|---|---|
| name | Oui | Nom d'affichage |
| images | Oui | Tableau d'images faciales en base64 (base64 brut, pas de data URLs) |
| gender | Oui | M ou F |
| date_of_birth | Oui | YYYY-MM-DD |
| collection_id | Oui | Id unique d'une seule collection |
| liveness_min_score | Oui | 0,5–1 |
| min_score | Oui | Seuil de recherche interne, 0,5–1 |
| search_mode | Oui | FAST ou ACCURATE |
| nationality | Non | Facultatif |
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>"],
}),
});- Cette démo utilise createPersonWithLiveness de @humanauthn/api-client avec le jeton de votre session.
- Les réponses peuvent inclure un bloc signature avec data selon l'environnement.
Documentation associée
Guides officiels sur docs.verifik.co
L'objet Person
Champs et structure d'un enregistrement personne de reconnaissance faciale.
Lister toutes les personnes
Personnes de votre client, avec filtres facultatifs.
Obtenir une personne
Une personne par id.
Mettre à jour une personne
Profil, images, collections et plus.
Supprimer une personne
Supprime un enregistrement personne par id.
Créer une personne avec vivacité
Vivacité, recherche de doublons et enrôlement en une requête.
Démo Mettre à jour une personne
Modifiez le profil ou les collections d'un id personne existant.
Démo Supprimer une personne
Suppression complète ou retrait d'une seule collection.