Todas as coleções
Integrações
Códigos de retorno REST da API
Códigos de retorno REST da API
Yuri Takaes avatar
Escrito por Yuri Takaes
Atualizado há mais de uma semana

Este artigo lista os possíveis códigos de status HTTP que você poderá receber ao realizar alguma requisição em nossa API.

Êxito

Receber qualquer código de status 2xx indica que a request foi recebida e processada com êxito.

Erro

Os códigos de status 4xx e 5xx indicam um erro, como mostra a lista abaixo:

  • 400 - Bad Request

  • 401 - Unauthorized

  • 403 - Forbidden

  • 404 - Not Found

  • 422 - Unprocessable Entity

  • 500 - Internal Server Error

A tabela abaixo detalha cada um deles:

Código HTTP

Status HTTP

Métodos comumente encontrados

Descrição

400

Bad Request

POST, PUT

Provavelmente existe algo errado com o corpo da sua requisição Verifique se todas as chaves, vírgulas e aspas estão nos lugares corretos. Dica: utilize os request bodies do swagger como base;

401

Unauthorized

GET, POST, PUT, DEL

Você não está logado., Verifique suas informações de autenticação nos Headers (X-Auth-Login, X-Auth-Register, X-Auth-Token);

403

Forbidden

GET, POST, PUT, DEL

Normalmente retornado ao tentar consultar ou realizar uma ação que você não tem permissão;

404

Not Found

GET, DEL

Normalmente retornado ao tentar consultar ou excluir algo com ID incorreto ou que foi excluído;

422

Unprocessable Entity

POST, PUT

Algum item obrigatório está vazio ou com valor inválido no request body. Por exemplo, o nome ou algum ID da entidade que você está tentando criar/alterar;

500

Internal Server Error

GET, POST, PUT, DEL

Erro interno do servidor;

Respondeu à sua pergunta?