Unico IDCloud - DevCenter
Página inicialAutenticaçãoAPIsSDKs
Portuguese (Brazil)
Portuguese (Brazil)
  • Introdução
  • SOBRE O IDCLOUD
    • Unico IDCloud
    • Capacidades
    • Meios de Integração
    • Capacidades e Meios de Integração
  • INTEGRAÇÃO
    • Guia de início rápido
    • Autenticação
      • Criando uma Conta de Serviço
      • Preparando para fazer uma requisição autenticada à API
      • Recursos adicionais
        • Exemplo em Javascript
        • Erros de autenticação
        • Postman Collection
    • Integração by Unico
      • Visão Geral
      • API
        • API Reference
          • Criação do Processo
            • Criação de processos separados por flows
          • Consultar Resultado do Processo
          • Obter Selfie do Usuário
          • Obter Conjunto Probatório
            • Especificação do conjunto probatório
          • Obter Documento Assinado
          • Obter Conjunto Probatório do Documento Assinado
        • Erros
      • Controlando a experiência
        • Redirecionando o usuário
        • SDK
        • QR Code
        • Personalizações
      • Recursos adicionais
        • Postman Collection
        • PoCs disponíveis
    • Integração by Client
      • Visão Geral
      • API
        • API Reference
          • Prova de vida + Verificação de Identidade + Alerta de comportamento
          • Prova de vida + Verificação de Identidade + Alerta de comportamento + Score de risco
          • Prova de vida + Validação 1:1 + Alerta de comportamento
          • Reaproveitamento e captura de documentos
        • Cenários de response
        • Erros
        • Recursos adicionais
          • Postman Collection
      • Padrão de captura (sem SDK)
    • Webhook
    • SDK
      • Visão Geral
      • Política de atualizações
      • Integração SDKs
        • SDK Android
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
          • Guia de tratamento de erros
          • Personalização Android
          • Solução de problemas
          • Release notes
        • SDK iOS
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
          • Guia de tratamento de erros
          • Personalização iOS
          • Solução de problemas
          • Release notes
        • SDK Flutter
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
          • Guia de tratamento de erros
          • Personalização Flutter
          • Solução de problemas
          • Release notes
        • SDK Web
          • Guia de instalação
          • Guia de uso e integração
            • Captura de Selfie
            • Captura de documento
            • Acessibilidade
          • Guia de tratamento de erros
          • Personalização Web
          • Release notes
      • Recursos adicionais
        • PoCs disponíveis
        • Melhores práticas de implementação da SDK
  • help & faq
    • Glossário
    • FAQs
      • FAQ IDCloud
      • FAQ Autenticação
      • FAQ SDK
    • Central de ajuda
Fornecido por GitBook

Institucional

  • Sobre nós

Copyright © 2024 unico. All rights reserved

Nesta página
  • Introdução
  • Erros possíveis
  • Criar Processo
  • Consultar Resultado do Processo

Isto foi útil?

Exportar como PDF
  1. INTEGRAÇÃO
  2. Integração by Client
  3. API

Erros

Nesta seção, você encontrará a visão geral sobre os erros que pode receber nos endpoints da plataforma Unico IDCloud


Introdução


A plataforma IDCloud utiliza códigos de resposta HTTP convencionais para indicar o sucesso ou falha de uma solicitação de API.

Como regra geral:

  • Códigos no intervalo 2xx indicam sucesso na requisição;

  • Códigos no intervalo 4xx indicam parâmetros incorretos ou incompletos (por exemplo, um parâmetro obrigatório foi omitido ou uma operação falhou com terceiros, etc.);

  • Códigos no intervalo 5xx indicam que houve um erro nos servidores da plataforma Unico IDCloud.

A plataforma Unico IDCloud também gera uma mensagem de erro e um código de erro formatado em JSON:

{
    "error": {
        "code": "0000",
        "description": "error description"
    }
}

Erros possíveis


Neste tópico, você encontrará os possíveis erros dos endpoints, separados por seu HTTP response.

Criar Processo


Consultar Resultado do Processo



AnteriorCenários de responsePróximoRecursos adicionais

Atualizado há 4 meses

Isto foi útil?

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da .

​
Central de Ajuda
code
message
Descrição

20023

O parâmetro processId não foi informado.

Falta o parâmetro id do processo.

20002

O parâmetro APIKey não foi informado.

Falta o parâmetro APIKEY no header da requisição.

20001

O parâmetro authtoken não foi informado.

QFalta o parâmetro do token de integração no header da requisição.

code
message
Descrição

50001

O processo informado não foi encontrado.

O processo não existe na base de dados.

code
message
Descrição

30017

O usuário não tem permissão para executar está ação.

Quando o access-token utilizado contém caracteres errados.

10502

O token informado está expirado.

Quando o access-token utilizado expirou.

10501

O token informado é inválido.

O token de autenticação é inválido.

10201

O AppKey informado é inválido.

O parâmetro APIKEY não foi informado ou não existe.

code
message
Descrição

99999

Internal failure! Try again later

Quando há algum erro interno.

code
message
Descrição

20900

O base64 informado não é válido.

O parâmetro base64 é inválido. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.

20807

A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.

A resolução da imagem enviada é muito pequena.

20507

O parâmetro subject.code é inválido.

CPF fora do padrão ou inexistente.

20506

O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.

Quando o e-mail informado não é vA imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.

20505

O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp.

Quando o telefone informado não é válBase64 inválido. Possíveis causas: não é uma imagem válida ou prefixo inválido.

20009

O parâmetro imagebase64 não foi informado.

Falta o parâmetro imagebase64, que contém a selfie da pessoa.

20006

O parâmetro subject.name não foi informado.

Falta o parâmetro subject.name, que contém o nome da pessoa.

20005

O parâmetro subject.code não foi informado.

Falta o parâmetro subject.code, que contém o cpf da pessoa.

20004

O parâmetro subject não foi informado.

Falta o parâmetro subject, que contém os dados da pessoa (cpf, nome).

20003

The request body is missing or invalid.

Payload nulo ou inválido.

20002

O parâmetro APIKey não foi informado.

Falta o parâmetro APIKEY no cabeçalho da requisição.

20001

O parâmetro authtoken não foi informado

Falta o parâmetro do token de integração no cabeçalho da requisição.

10508

The JWT with the captured face has already been used.

O .jwt só pode ser usado uma única vez.

10507

The JWT with the captured face is expired.

JWT expirado. O .jwt deve ser enviado em até 10 minutos.

10506

The bundle is invalid.

Bundle inválido. APIKEY usa um método de segurança e esta solicitação não atende aos requisitos de segurança (SDK).

code
message
Descrição

30017

Jwt header is an invalid JSON.

Quando o access-token utilizado contém caracteres errados.

10502

O token informado está expirado.

Quando o access-token utilizado expirou

10501

O token informado é inválido.

O token de autenticação é inválido.

10201

O AppKey informado é inválido.

O parâmetro APIKEY não foi informado ou não existe.

code
message
Descrição

99999

Internal failure! Try again later

Quando há algum erro interno.