1:1 - Face Match

Compara duas imagens faciais (ex: selfie vs. foto de documento) e retorna score de similaridade via AWS Lambda.

🔗 Endpoint:

Método: POST

URL: https://api.nuvidio.com/v1/api/facial-biometrics/face-match

Request

Multipart form-data:

Campo	Tipo	Obrigatório	Descrição
`referenceImage`	arquivo	Sim	Imagem de referência (máx 1 arquivo)
`comparisonImage`	arquivo	Sim	Imagem a comparar (máx 1 arquivo)

curl -X POST https://api.nuvidio.com/v1/api/facial-biometrics/face-match \
  -H "Authorization: Basic <base64(apiKey:apiSecret)>" \
  -F "[email protected]" \
  -F "[email protected]"

✅ Resposta de Sucesso ( 200 )

{
	"result": true,
	"score": 0.87
}

result: boolean (match ou não). score: float ou null.

Respostas de Erro:

Status	Quando ocorre
`400`	Uma das duas imagens ausente (validado neste repo)
`405`	Feature `allowFaceMatch` desabilitada para a empresa
`400`	Imagem ausente no payload
`415`	Formato de imagem inválido
`422`	Rosto não detectado em uma das imagens
`429`	Rate limit excedido
`500`	Erro inesperado no processamento

Corpo de erro:

{
	"error": string,
	"description": string
}