Passar para o conteúdo principal

Códigos de retorno REST da API

Yuri Takaes avatar
Escrito por Yuri Takaes
Atualizado há mais de 2 anos

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?