Validação de identidade por biometria facial. Requer feature habilitada na empresa.
Valida se uma selfie corresponde ao CPF informado, usando provedor configurado (idwall ou Serpro Datavalid).
🔗 Endpoint:
Método: POST
URL: https://api.nuvidio.com/v1/api/facial-biometrics/identity-check
Request
Multipart form-data:
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
cpf | string | Sim | CPF a validar |
file | arquivo (imagem) | Sim | Selfie, até 20MB |
curl -X POST https://api.nuvidio.com/v1/api/facial-biometrics/identity-check \
-H "Authorization: Basic <TOKEN>" \
-F "cpf=12345678900" \
-F "[email protected]"
✅ Resposta de Sucesso ( 200 )
{
"trustLevel": "HIGH"
}
trustLevel: "HIGH" ou "LOW" (Serpro) — provedor idwall retorna seu próprio range de trustLevel.
Respostas de Erro:
| Status | Quando ocorre |
|---|---|
422/400 | Arquivo ausente, ou erro do provedor externo (idwall/Serpro) |
413 | Arquivo maior que 1MB (limite pós-upload no controller, diferente do limite de 20MB do Multer) |
405 | Feature allowFacialBiometric desabilitada para a empresa |
500 | Provedor não retornou trustLevel |