Comparação facial

Etapa 1 de 3
1
Origem
2
Alvo
3
Analisar

Identificação de origem

A assinatura biométrica principal usada na verificação.

menu_bookReferência da API: Face Comparisonexpand_more

Documentação oficial: docs.verifik.co/biometrics/compare

As páginas públicas da Verifik podem descrever campos extras em outros ambientes. Esta demo HumanAuthn chama a rota Verifik que aceita apenas gallery, probe e compare_min_score opcional.

POST /v2/face-recognition/compare

Compara imagem(ns) de prova à(s) de galeria e retorna pontuação de similaridade. O backend define passed quando a pontuação atinge seu compare_min_score (ou o padrão do servidor se omitido).

CabeçalhoValor
Content-Typeapplication/json
AuthorizationBearer <token>
ParamTipoObrig.Descrição
gallerystring[]SimFace(s) de referência, base64 (sem prefixo data URL)
probestring[]SimFace(s) a comparar, base64
compare_min_scorenumberNão0,67 a 0,95. Padrão do servidor 0,85 se omitido
await fetch("https://api.verifik.co/v2/face-recognition/compare", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    gallery: ["<base64>"],
    probe: ["<base64>"],
    compare_min_score: 0.85,
  }),
});
// 200 OK, example shape
{
  "id": "…",
  "data": {
    "result": {
      "score": 0.91,
      "compare_min_score": 0.85,
      "passed": true
    },
    "compare_min_score": 0.85
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "…"
  }
}
  • As imagens devem ser payloads base64 reais. Strings muito curtas são rejeitadas (ex.: 412:only_images_in_base64).
  • O controle de pontuação mínima define compare_min_score na requisição (0,67 a 0,95; inicia no padrão do cliente da API 0.85).
  • As respostas costumam incluir id e bloco de assinatura junto de data.