Nesta seção, você encontrará a visão geral sobre os erros que pode receber nos endpoints da plataforma Unico IDCloud
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:
Neste tópico, você encontrará os possíveis erros dos endpoints, separados por seu HTTP response.
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.
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).
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.
99999
Internal failure! Try again later
Quando há algum erro interno.
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.
50001
O processo informado não foi encontrado.
O processo não existe na base de dados.
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.
99999
Internal failure! Try again later
Quando há algum erro interno.