Match

Parâmetros

Como parâmetro da API, deverá ser enviada uma rota POST para o endpoint /api/v1/match com o ID do cliente, a face que passará pelo processo de Match 1:N em base64, token e a função "ativarLiveness" true/false. Exemplo de JSON:

{
"face":"/9j/4DAWLFK...",
"clientid":"658cc36e-XXXX-XXXX-XXXX-29711f9566aa",
"ativarLiveness":true/false,
"token":"0002221"
}

As informações são enviadas para a API Facesign e logo após, para o Liveness 2D.

Parâmetro Liveness desativado

Com o Parâmetro Liveness desativado, o Match 1:N poderá ser realizado com sucesso mesmo com o retorno negativo do Liveness. Após o retorno do Liveness (positivo ou negativo), a API realizará a consulta da face no container do perfil do cliente, retornando o status do Match, nível do Match (caso tenha), Liveness e ID de transação:

• Liveness negativo e face não encontrada

Code 400 - Erro

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"face":"/9j/4AAQSkZJRgABAQAA...",
"status":"Face não localizada",
"Liveness":false,
"transactionId":"123456"
}

• Liveness negativo e Match ok

Code 200 - Sucesso

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"id":"cli0001",
"status":"Match ok",
"Liveness":false,
"nivelMatch":99.51,
"transactionId":"123456"
}

• Liveness positivo e face não encontrada

Code 400 - Erro

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"face":"/9j/4AAQSkZJRgABAQAA...",
"status":"Face não localizada",
"Liveness":true,
"transactionId":"123456"
}

• Liveness positivo e Match ok

Code 200 - Sucesso

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"id":"cli0001",
"status":"Match ok",
"Liveness":true,
"nivelMatch":99.51,
"transactionId":"123456"
}

Parâmetro Liveness ativado

Com o Parâmetro Liveness ativado, o Match só será realizado com o retorno positivo do Liveness:

• Liveness positivo e face não encontrada

Code 400 - Erro

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"face":"/9j/4AAQSkZJRgABAQAA...",
"status":"Face não localizada",
"Liveness":true,
"transactionId":"123456"
}

• Liveness positivo e Match ok

Code 200 - Sucesso

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"id":"cli0001",
"status":"Match ok",
"Liveness":true,
"nivelMatch":99.51,
"transactionId":"123456"
}

• Liveness negativo

Code 400 - Erro

{
"clientId":"30af224e-XXXX-XXXX-XXXX-b2a7d2081a59",
"face":"/9j/4AAQSkZJRgABAQAA...",
"status":"failure",
"Liveness":false
}