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

---

400 Bad Request

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.	A 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.	Base64 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).

403 Forbidden

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.

500 Internal Server Error

code	message	Descrição
99999	Internal failure! Try again later	Quando há algum erro interno.

Consultar Resultado do Processo

---

400 Bad Request

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.

404 Not Found

code	message	Descrição
50001	O processo informado não foi encontrado.	O processo não existe na base de dados.

403 Forbidden

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.

500 Internal Server Error

code	message	Descrição
99999	Internal failure! Try again later	Quando há algum erro interno.

---

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.