Códigos de Resposta HTTP
Os códigos de status das respostas HTTP indicam se uma requisição HTTP foi corretamente concluída, abaixo temos uma tabela com os possíveis códigos de resposta que a API pode responder.
Código | Situação | Observação |
---|---|---|
200 OK | Requisição foi bem sucedida. | |
201 Created | Requisição foi bem sucedida. | A operação resulta na criação de um novo recurso. |
400 Bad Request | A requisição foi malformada, indica que o servidor não pode ou não irá processar a requisição devido a alguma coisa que foi entendida como um erro do cliente. | A operação solicitada não será realizada. |
401 Unauthorized | Cabeçalho de autenticação ausente ou inválido. | A operação foi recusada devido a falha na autenticação. |
403 Forbidden | Algum parâmetro ausente ou inválido. | |
404 Not Found | O recurso solicitado não existe ou não foi implementado. | |
422 Unprocessable Entity | A requisição foi bem formada, mas não pôde ser processada devido à regra de negócio específica da solicitação. | Um payload com código, messagem e tipo do erro será retornado. |
429 Too Many Requests | A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período. | |
500 Internal Server Error | Ocorreu um erro inesperado na API e não foi possível atender a requisição. | |
503 Service Unavailable | O serviço está indisponível no momento. | |
504 Gateway Timeout | O servidor não pôde responder em tempo hábil. |