Criar pessoa com vivacidade

Cadastro + verificação de vivacidade + busca por duplicatas em uma única chamada.

menu_bookReferência da API: criar pessoa com vivacidadeexpand_more

Documentação (inglês): docs.verifik.co/resources/create-a-person-with-liveness

Documentação (espanhol): docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida

URL base https://api.verifik.co. Envie JSON com campos de perfil, um único collection_id (_id da coleção), limiares de vivacidade e busca, e pelo menos uma imagem facial em base64 por entrada em images (sem prefixo data URL).

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

Executa vivacidade no(s) rosto(s) enviado(s), busca cadastros semelhantes e cria ou atualiza uma pessoa na coleção alvo.

Cabeçalho	Valor
Content-Type	application/json
Authorization	Bearer <token>

Param	Obrig.	Descrição
name	Sim	Nome de exibição
images	Sim	Array de imagens faciais em base64 (base64 puro, não data URLs)
gender	Sim	M ou F
date_of_birth	Sim	YYYY-MM-DD
collection_id	Sim	Id único de uma única coleção
liveness_min_score	Sim	0.5–1
min_score	Sim	Limiar interno de busca, 0.5–1
search_mode	Sim	FAST ou ACCURATE
nationality	Não	Opcional

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>"],
  }),
});

Esta demo usa createPersonWithLiveness de @humanauthn/api-client com o token da sua sessão.
As respostas podem incluir um bloco signature junto de data conforme o ambiente.

menu_book

Guias oficiais em docs.verifik.co

Object

O objeto Person

Campos e estrutura de um registro de pessoa de reconhecimento facial.

GET

Listar todas as pessoas

Pessoas do seu cliente, com filtros opcionais.

GET

Obter uma pessoa

Uma única pessoa por id.

PUT