Buscar usuário ativo

Busca facial 1:N sem vivacidade — para fluxos de usuário ativo e sessão (uma imagem de prova).

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

Documentação oficial: docs.verifik.co/biometrics/search-active-user (busca 1:N sem vivacidade — fluxos de usuário ativo / sessão).

URL base https://api.verifik.co. Envie uma prova em base64 cru em image, os obrigatório (ANDROID, IOS ou DESKTOP), além de min_score e search_mode. Esta demo usa DESKTOP.

POST /v2/face-recognition/search-active-user

Semelhante à busca ao vivo, mas sem etapa de vivacidade — quando o usuário já está em sessão autenticada ou confiável.

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
min_score	Sim	Limiar de correspondência (0,5–1,0)
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-active-user", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});

Esta demo usa searchActiveUser de @humanauthn/api-client com o token da sua sessão.
Para vivacidade + 1:N, use search-live-face (veja Face Search 1:N Live na documentação).

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