Cadastrar uma face através do Backoffice da Fortface

Use esse endpoint para cadastrar uma face utilizando o Backoffice da Fortface.

curl --location --request POST 'https://horizon-api-sb.app.rpe.tech/api/v1/biometria/backoffice/enroll' \ --header 'fortfaceAuthorizationToken;' \ --header 'Content-Type: application/json' \ --data-raw '{ "externalUserId": "90187063091", "imgData": "{{imgRosto}}", "analysis": { "liveness": true } }'

{ "photo": { "liveness": { "value": true, "confidence": 70 }, "eyesOpen": { "left": { "value": true, "confidence": 91 }, "right": { "value": true, "confidence": 73 } } }, "hash": "3DGPA/eFozPL4sY/5Sy1MChMQLyPlP5s1huxxxowyfJ1xuODyQGOeh9JGpdZKiO9KuaxQOymuXQYvLgx8U4A8g==", "api": { "version": "v1 - 2.5.0", "timestamp": "1741705131566", "env": "sandbox" } }

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

fortfaceAuthorizationToken

string

requerido

Hash de autorização da Fortface.

Exemplo:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...

Parâmetros Bodyapplication/json

externalUserId

string

opcional

Identificador do usuário (CPF), sem pontuação

Exemplo:

2001

imgData

string

opcional

Imagem criptografada.

Exemplo:

"{{imgRosto}}"

analysis

object

opcional

Informações sobre análise de prova de vida.

liveness

boolean

opcional

Verificação de prova de vida.

Padrão:

true

Exemplo:

true

Examples

Respostas

🟢200OK

application/json

Body

photo

object

opcional

Contém os dados da imagem analisada, incluindo verificações biométricas.

liveness

object

opcional

Resultado da verificação de prova de vida.

eyesOpen

object

opcional

Avaliação da abertura dos olhos na imagem capturada.

hash

string

opcional

Hash gerado a partir da captura biométrica para garantir integridade e unicidade dos dados.

Exemplo:

3DGPA/eFozPL4sY/5Sy1MChMQLyPlP5s1huxxxowyfJ1xuODyQGOeh9JGpdZKiO9KuaxQOymuXQYvLgx8U4A8g==

api

object

opcional

Informações sobre a API utilizada no processo.

version

string

opcional

Versão da API.

Exemplo:

v1 - 2.5.0

timestamp

string

opcional

Marca temporal do momento em que a resposta foi gerada, representada no formato Unix Timestamp em milissegundos.

Exemplo:

1741705131566

env

string

opcional

Ambiente da API.

Exemplo:

sandbox

🟠400Pedido inválido

🟠401Não autorizado

🟠403Proibido

🟠404Registro não encontrado

🔴500Erro do servidor