Erros Comuns

Introdução

Utilizamos códigos HTTP para distinguir entre requisições realizadas com sucesso e aquelas que apresentam falhas. Cada erro é acompanhado por um tipo, uma mensagem e uma descrição detalhada.

Erros de categoria 4xx indicam problemas relacionados à entrada de dados incorretos ou insuficientes.

Erros de categoria 5xx sinalizam problemas internos do serviço.

Segue uma lista exemplar de códigos e mensagens de erro que podem ser encontrados ao utilizar nossa API.

VALIDATION_ERROR

Ocorre quando houve erros na validação dos campos enviados pela requisição.

HTTP Code:

400

MISSING_REQUIRED_FIELD_ERROR

Ocorre quando campos obrigatórios não foram enviados.

HTTP Code:

400

UNKNOWN_ERROR

Ocorre quando uma operação não pode ser concluida.

HTTP Code:

400

UNAUTHORIZED

Ocorre quando a chave de acesso informada não está válida.

HTTP Code:

401

FORBIDDEN

Ocorre quando o token enviado não possui permissão para operar nos escopos requisitados.

HTTP Code:

403

RESOURCE_NOT_FOUND

Ocorre quando a URN ou URI informada não existe, ou quando o recurso solicitado não foi encontrado no sistema.

HTTP Code:

404

TOO_MANY_REQUESTS

Ocorre quando o total de requisições feitas atingiu o seu limite.

HTTP Code:

429

SERVER_ERROR

Ocorre quando algum processo interno no servidor da nossa aplicação possui alguma falha.

HTTP Code:

500

Para testes e maiores informações acesse nosso repositório no Postman. SNDesk Postman