Buscar pessoa

Envie imagens faciais para buscar pessoas cadastradas por similaridade (1:N).

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

Documentação oficial: docs.verifik.co/biometrics/search (Face Search — busca por imagem facial em pessoas cadastradas).

URL base https://api.verifik.co. Envie uma ou mais imagens em base64 cru da mesma pessoa em images (sem prefixo data URL). Opcionalmente limite com collection_id. A documentação recomenda 1–3 imagens para melhor recall.

POST /v2/face-recognition/search

Identificação 1:N: retorna candidatos ordenados por pontuação de similaridade.

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

Param	Obrig.	Descrição
images	Sim	Array de imagens faciais em base64 (mesma pessoa; até ~3 sugeridas)
min_score	Sim	Limiar de correspondência (ex.: 0,2–1,0)
search_mode	Sim	FAST ou ACCURATE
collection_id	Não	Limitar a busca a uma coleção
max_results	Não	Teto de correspondências retornadas (padrão da API se omitido)

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

Esta demo usa searchPerson de @humanauthn/api-client com o token da sua sessão.
As respostas costumam incluir correspondências ordenadas e podem incluir assinatura conforme o ambiente.

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