Combate à Fraude Docs

Combate à Fraude Docs

    ›API

    Introdução

    • Início
    • Token de acesso
    • Checando as respostas assinadas
    • Checklist de integração

    Android

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • FaceAuthenticator
    • AddressCheck
    • DeviceAnalyser
    • Customização
    • Resultado de um SDK
    • Reduzindo o tamanho dos SDKs
    • Configuração dos sensores
    • Configuração de proxy
    • Configuração de preview
    • Formulário de segurança Google
    • Analytics
    • Notas de atualização

    iOS

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • FaceAuthenticator
    • AddressCheck
    • DeviceAnalyser
    • Customização
    • Configuração de proxy
    • Notas de atualização

    Flutter

    • Primeiros passos
    • Notas de atualização

    React Native

    • Primeiros passos

    Ionic

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • Notas de atualização

    Xamarin

    • Primeiros passos

    JavaScript

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • FaceAuthenticator
    • Erros do SDK
    • Customização
    • Eventos do SDK
    • Notas de atualização (DocumentDetector)
    • Notas de atualização (PassiveFaceLiveness)
    • Notas de atualização (FaceAuthenticator)

    API

    • Primeiros passos
    • Assinatura de respostas
    • Registro Facial
    • Autenticação Facial
    • Prova de vida passiva
    • Autenticação de dispositivos
    • Comprovante de endereço digital

    Autenticação Facial

    Informações gerais

    • Endereço: api.mobile.combateafraude.com/faces/authenticate
    • Suporta assinatura de respostas: Sim

    Método POST

    Descrição

    Verifica se o rosto em uma imagem bate com o registrado para um CPF.

    ATENÇÃO: Se você não está usando o processo de onboarding oferecido pela combateafraude, você deve chamar a rota de registro facial antes de usar essa rota.

    Requisição

    Cabeçalhos

    IdentificadorValorDescrição
    Authorization[token de acesso]Token do acesso do cliente mais informações
    Content-typeapplication/jsonEspecifica que o MIME type é JSON

    Strings de consulta

    IdentificadorObrigatórioValorDescrição
    shouldSignResponseNãotrue ou falseEspecifica se a request deve ser assinada. O default é false.

    Corpo

    CampoObrigatórioTipoDescrição
    peopleIdSimStringCPF do usuário que deseja autenticar
    imageUrlNão*StringURL da imagem a ser validada
    imageBase64Não*StringBase64 da imagem a ser validada
    deviceNãoObjetoInformações básicas do dispositivo sendo usado para autenticar (ver abaixo)

    *Você deve enviar um dos dois campos.

    Informações do dispositivo:

    CampoDescrição
    fingerprintIdentificador único do dispositivo
    operatingSystemSistema operacional do dispositivo
    manufacturerFabricante do dispositivo
    modelModelo do dispositivo

    Resposta

    Códigos de status

    CódigoGera cobrançaDescrição
    200SimA execução foi concluída com sucesso
    400NãoO token de acesso não foi informado
    401NãoO token usado não é válido para este produto
    404NãoNenhum rosto cadastrado para o CPF informado
    405NãoMétodo HTTP não permitido
    500NãoErro interno do servidor

    Corpo da resposta quando bem-sucedida

    CampoValores válidosDescrição
    requestIdStringIdentificador dessa requisição em nosso servidores
    isMatchBooleanIndica se a autenticação facial foi aprovada.

    Exemplos

    Exemplo de requisição:

    curl --location \
        --request POST 'api.mobile.combateafraude.com/faces/authenticate' \
        --header 'Authorization: {token}' \
        --header 'Content-Type: application/json' \
        --data-raw '{
            "peopleId": "{cpf}",
            "device": {
                "operatingSystem": "iOS",
                "fingerprint": "53fb86d3861f976886exe2e5b9291ea4",
                "manufacturer": "iPhone",
                "model": "iPhone 8 Plus"
            },
            "imageUrl": "https://images.generated.photos/DQ4EKrAPT-e5slG3cXmSw20uJ2AwwhOzJeVnpI9tlMA/rs:fit:512:512/Z3M6Ly9nZW5lcmF0/ZWQtcGhvdG9zLzA5/OTk4MDcuanBn.jpg"
        }'
    

    Exemplo de resposta:

    {
        "requestId": "dec967ad-e0e5-4a00-8c33-c82a84971ddf",
        "isMatch": true
    }
    
    ← Registro FacialProva de vida passiva →
    • Informações gerais
    • Método POST
      • Descrição
      • Requisição
      • Resposta
      • Exemplos
    Combate à Fraude Docs
    2021 © Combate à Fraude - Todos os direitos reservados.
    COMBATEAFRAUDE TECNOLOGIA DA INFORMACAO LTDA CNPJ: 34.102.645/0001-57
    R. Tiradentes, 1077 - 5º andar - Centro, Venâncio Aires - RS, CEP 95800-000