Buscar pessoa ao vivo

Vivacidade em uma imagem de prova e depois busca facial 1:N (ao vivo).

menu_bookReferência da API: Face Search 1:N (Live)expand_more

Documentação oficial: docs.verifik.co/biometrics/search-live-face (vivacidade na imagem de prova e depois busca 1:N).

URL base https://api.verifik.co. Envie uma única prova em base64 cru em image (sem prefixo data URL), os obrigatório (ANDROID, IOS ou DESKTOP), limiares de vivacidade e correspondência e search_mode. Esta demo usa DESKTOP.

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

Executa anti-spoofing / vivacidade primeiro; se passar, faz busca por similaridade nas faces cadastradas.

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

Param	Obrig.	Descrição
image	Sim	Única imagem de prova em base64
os	Sim	ANDROID, IOS ou DESKTOP
liveness_min_score	Sim	Limiar de vivacidade (0,5–1,0)
min_score	Sim	Limiar de correspondência (0,5–1,0 conforme a doc)
search_mode	Sim	FAST ou ACCURATE
collection_id	Não	Limitar a busca a uma coleção

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

Esta demo usa searchLivePerson de @humanauthn/api-client com o token da sua sessão.
Falhas abaixo do limiar de vivacidade podem retornar erro (veja a doc para o formato).

menu_book

Guias oficiais em docs.verifik.co

Object

O objeto Person

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

GET

Listar todas as pessoas

Pessoas do seu cliente, com filtros opcionais.

GET

Obter uma pessoa

Uma pessoa pelo id.

PUT