> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-api/guias-tecnicos/codigos-de-status-das-respostas.md).

# 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-api/guias-tecnicos/codigos-de-status-das-respostas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.