Antispoofing Facial

O serviço de Antispoofing Facial analisa uma selfie e responde a uma única pergunta: esta imagem veio de uma pessoa real diante da câmera ou de uma tentativa de falsificação? Detecta fotocópias, capturas de tela, a borda de outra tela dentro do quadro, marcas d’água, alterações cromáticas e deepfakes gerados por IA. Integração com uma única chamada HTTP, sem SDK.

A regra de decisão

Esta é a parte mais importante da integração. Escreva-a na forma positiva:

// Aprovar exige as duas condições. Qualquer outra coisa NÃO é uma aprovação.
if (status === 200 && body.spoofing === false) {
  aprovar();
} else {
  naoAprovar();
}

Nunca aprove por exclusão. Não existe um código único que signifique «rejeitado»: o veredito de falsificação chega com 200, enquanto uma imagem sem rosto chega com 422 e também traz spoofing: true. Se a sua condição for «rejeitar quando o código for X», toda resposta inesperada acaba aprovada.

Não decida com base em errorCode, values, confidence ou info. Esses campos são diagnóstico: servem para o seu log e para abrir um chamado com contexto. Mudam entre versões e não fazem parte do contrato.

Endpoints

Método	Caminho	Para que serve
`GET`	`/version`	Verificar conectividade e credenciais. Avalie o código de status, não o corpo.
`POST`	`/inference`	Analisar uma imagem e obter o veredito.

A URL base depende do ambiente e é fornecida pela VU junto com a sua api-key. Nos exemplos ela aparece como BASE_URL.

Autenticação

Toda chamada leva o cabeçalho Api-Key com a chave do seu ambiente.

curl -X GET "$BASE_URL/version" \
  -H "Api-Key: $VU_AS_FACE_API_KEY"

A api-key vive no seu backend. Nunca a embuta em um app móvel nem no front-end: qualquer pessoa consegue extraí-la do binário ou do bundle.

Um exemplo completo

curl -X POST "$BASE_URL/inference" \
  -H "Api-Key: $VU_AS_FACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "info": "onboarding-12345",
    "logAnonymity": true,
    "image": "/9j/4AAQSkZJRgABAQAAAQABAAD...v9Un0ooqDE//2Q=="
  }'

Uma aprovação se parece com isto, reduzida aos campos que importam:

{
  "id": "f80aaaf6-b3fe-44ab-9388-79d42b7a5f0e",
  "code": 200,
  "spoofing": false,
  "message": "Machine Learning indicates not Spoofing",
  "confidence": 99,
  "benchmark": 248
}

id é o identificador da transação. Registre-o sempre: é a primeira coisa que o suporte vai pedir.

Ambientes

O ambiente de homologação pode estar à frente da produção. Ele também valida versões pré-produtivas, então pode diferir em tempo de resposta e no resultado da análise. Use-o para certificar a sua integração — o contrato, os códigos, o tratamento de erros —, não como referência de performance nem para comparar vereditos imagem a imagem entre ambientes.

Continuar

Integração

Prepare a imagem, monte a chamada e valide a integração antes da produção.

Respostas

O que cada resposta traz, como info se comporta e qual componente bloqueou.

Erros

Códigos, de quem é cada problema e quais podem ser repetidos.

Comece aqui

ID Analysis

Face Analysis

Connection Fingerprint

Antispoofing Facial

A regra de decisão

Endpoints

Autenticação

Um exemplo completo

Ambientes

Continuar

Integração

Respostas

Erros

​A regra de decisão

​Endpoints

​Autenticação

​Um exemplo completo

​Ambientes

​Continuar

Integração

Respostas

Erros

A regra de decisão

Endpoints

Autenticação

Um exemplo completo

Ambientes

Continuar