# Códigos de Resposta

Toda requisição feita à API retorna um código de status ***HTTP (HTTP Status Code)*** que informa o resultado do processamento. Utilizamos os padrões convencionais da web para indicar o sucesso ou falha das requisições.

## Respostas de Sucesso (2xx)

Indicam que a requisição foi recebida, compreendida e processada com êxito.

<table><thead><tr><th width="163">Código</th><th>Descrição</th></tr></thead><tbody><tr><td><code>200 OK</code></td><td><p>A solicitação foi bem-sucedida. O significado do resultado de "sucesso" depende do método HTTP:</p><p><br>GET: O recurso foi obtido e transmitido no corpo da mensagem.<br><br>HEAD: Os cabeçalhos de representação são incluídos na resposta sem nenhum corpo de mensagem.<br><br>PUT ou POST: O recurso que descreve o resultado da ação é transmitido no corpo da mensagem.</p></td></tr><tr><td><code>201 Created</code></td><td>A requisição foi bem sucedida e um novo recurso foi criado como resultado. Esta é normalmente a resposta enviada após as solicitações <code>POST</code> ou algumas solicitações <code>PUT</code>.</td></tr></tbody></table>

## Erros do Cliente (4xx)

Indicam que houve um problema com os dados enviados (ex: parâmetros inválidos, autenticação falha ou recurso não encontrado).

<table><thead><tr><th width="266">Código</th><th>Descrição</th></tr></thead><tbody><tr><td><code>400 Bad Request</code></td><td>O servidor não pode ou não irá processar a solicitação devido a algo que é percebido como um erro do cliente (por exemplo, sintaxe de solicitação malformada, enquadramento de mensagem de solicitação inválida ou roteamento de solicitação enganosa)</td></tr><tr><td><code>401 Unauthorized</code></td><td>Embora o padrão HTTP especifique "unauthorized", semanticamente, essa resposta significa "unauthenticated". Ou seja, o cliente deve se autenticar para obter a resposta solicitada.</td></tr><tr><td><code>403 Forbidden</code></td><td>O cliente não tem direitos de acesso ao conteúdo; ou seja, não é autorizado, portanto o servidor está se recusando a fornecer o recurso solicitado. Ao contrário do <code>401 Unauthorized</code>, a identidade do cliente é conhecida pelo servidor.</td></tr><tr><td><code>404 Not Found</code></td><td>O servidor não pode encontrar o recurso solicitado. No navegador, isso significa que o URL não é reconhecido. Em uma API, isso também pode significar que o endpoint é válido, mas o próprio recurso não existe. Os servidores também podem enviar esta resposta em vez de <code>403 Forbidden</code> para ocultar a existência de um recurso de um cliente não autorizado. Este código de resposta é provavelmente o mais conhecido devido à sua ocorrência frequente na web.</td></tr><tr><td><code>429 Too Many Requests</code></td><td>O usuário enviou muitas requisições num dado tempo ("limitação de frequência").</td></tr></tbody></table>

## Erros do Servidor (5xx)

Indicam que a API encontrou um erro inesperado ao tentar processar a solicitação.

<table><thead><tr><th width="296">Código</th><th>Descrição</th></tr></thead><tbody><tr><td><code>500 Internal Server Error</code></td><td>O servidor encontrou uma situação com a qual não sabe lidar.</td></tr><tr><td><code>502 Bad Gateway</code></td><td>Essa resposta de erro significa que o servidor, enquanto trabalhava como um gateway para obter uma resposta necessária para lidar com a solicitação, obteve uma resposta inválida. deve se autenticar para obter a resposta solicitada.</td></tr><tr><td><code>503 Service Unavailable</code></td><td>O servidor não está pronto para manipular a requisição Causas comuns são um servidor em manutenção ou sobrecarregado. Note que junto a esta resposta, uma página amigável explicando o problema deveria ser enviada. Esta resposta deve ser usada para condições temporárias e o cabeçalho HTTP <code>Retry-After</code> deverá, se possível, conter o tempo estimado para recuperação do serviço. O webmaster deve também tomar cuidado com os cabeçalhos relacionados com o cache que são enviados com esta resposta, já que estas respostas de condições temporárias normalmente não deveriam ser postas em cache.</td></tr><tr><td><code>504 Gateway Timeout</code></td><td>Essa resposta de erro é fornecida quando o servidor está atuando como um gateway e não consegue obter uma resposta a tempo.</td></tr></tbody></table>

Referência [https://developer.mozilla.org](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Status)

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>