Facematch — Comparação Facial

POST

/Facematch

Última modificação:2026-09-01 18:51:30

Compara a face presente em um documento com foto (CNH frente, RG frente) com uma selfie do titular, usando AWS Rekognition.

Fluxo interno: salva documento no S3 → tipifica (rejeita tipos sem foto) → salva selfie no S3 → chama Rekognition → retorna resultado de similaridade.

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Resultado da comparação facial

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

Envio por URLEnvio por base64

curl --location '/Facematch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "documento": "https://storage.example.com/docs/cnh-frente.jpg",
    "selfie": "https://storage.example.com/selfies/selfie-001.jpg",
    "cpf": "12345678900",
    "similaridade": "80",
    "conversation_id": "conv-fm-001"
}'

Response Example

200 - Match positivo

{
    "codigo_retorno": "0",
    "mensagem": "É a mesma pessoa",
    "similaridade": 92,
    "tempo_total": 2.31,
    "tipo_doc": ""
}

Modificado em 2026-09-01 18:51:30

Página anterior

Tipificação e Extração de Documentos

Próxima página

RequestDTO