Registro Facial

Informações gerais

• Endereço: api.mobile.combateafraude.com/faces/register
• Suporta assinatura de respostas: Não

Método POST

Descrição

Vincula o rosto na imagem enviada ao CPF informado em nossos sistemas.

Isso permitirá que a pessoa na foto use autenticação facial para provar que é a portadora desse documento.

ATENÇÃO: A API principal da combateafraude faz o registro do rosto ao final de um processo de onboarding. Caso você esteja usando esse serviço, não há necessidade de chamar essa rota separadamente.

Requisição

Cabeçalhos

Identificador	Valor	Descrição
Authorization	[token de acesso]	Token do acesso do cliente mais informações
Content-type	application/json	Especifica que o MIME type é JSON

Corpo

Campo	Tipo	Descrição
peopleId	String	CPF do usuário presente na imagem
imageUrl	String	URL da imagem contendo o rosto do usuário

Resposta

Códigos de status

Código	Gera cobrança	Descrição
200	Não	A execução foi concluída com sucesso
400	Não	O token de acesso não foi informado
401	Não	O token usado não é válido para este produto
405	Não	Método HTTP não permitido
500	Não	Erro interno do servidor

Corpo da resposta quando bem-sucedida

Campo	Tipo	Descrição
requestId	String	Identificador dessa requisição em nosso servidores
message	String	Mensagem padrão para cada status-code

Exemplos

Exemplo de requisição:

curl --location \
    --request POST 'api.mobile.combateafraude.com/faces/register' \
    --header 'Authorization: {token}' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "peopleId": "{cpf}",
        "imageUrl": "https://images.generated.photos/DQ4EKrAPT-e5slG3cXmSw20uJ2AwwhOzJeVnpI9tlMA/rs:fit:512:512/Z3M6Ly9nZW5lcmF0/ZWQtcGhvdG9zLzA5/OTk4MDcuanBn.jpg"
    }'

Exemplo de resposta:

{
    "requestId": "d70de7ec-486a-46fc-9030-08422b421daf",
    "message": "Ação realizada com sucesso"
}