> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/pt/api-publica-exoclick/api-manual-errors.md).

# Erros

Todos os erros devolverão o código de resposta HTTP mais específico e apropriado da tabela seguinte:

## Códigos de retorno

| Código | Erro                                | Descrição                                                                                                 |
| ------ | ----------------------------------- | --------------------------------------------------------------------------------------------------------- |
| 400    | Pedido inválido                     | Foi recebido do cliente um pedido malformado. Esta é a resposta mais genérica dada pela API               |
| 401    | Não autorizado                      | Não está autorizado e não pode aceder ao recurso solicitado                                               |
| 403    | Proibido                            | Não tem permissão para aceder ao recurso solicitado                                                       |
| 404    | Não encontrado                      | O recurso solicitado não pode ser encontrado. Poderá ficar disponível mais tarde                          |
| 405    | Método não permitido                | Foi usado um método HTTP não suportado para o recurso solicitado                                          |
| 406    | Não aceitável                       | O tipo Accept ou Accept-Encoding solicitado pelo cliente não está disponível                              |
| 409    | Conflito                            | O pedido não pode ser concluído porque existe um conflito com o recurso existente                         |
| 410    | Já não disponível                   | O recurso solicitado já não está disponível e nunca estará no futuro                                      |
| 411    | Comprimento necessário              | O recurso solicitado espera que o cliente forneça um Content-Length                                       |
| 413    | Entidade do pedido demasiado grande | O corpo do pedido fornecido pelo cliente era demasiado grande; o recurso recusa-se a processá-lo          |
| 415    | Tipo de media não suportado         | Foi fornecido pelo cliente um Content-Type incorreto (ou nenhum)                                          |
| 422    | Entidade não processável            | O pedido não está malformado e o tipo de media é aceitável, mas o recurso não consegue processar o pedido |
| 429    | Demasiados pedidos                  | O limite de taxa foi atingido. Consulte a secção de limitação de taxa para mais informações               |
| 500    | Erro interno do servidor            | O servidor não pôde processar o seu pedido devido a um erro interno inesperado                            |
| 501    | Não implementado                    | O recurso solicitado não foi implementado                                                                 |
| 503    | Serviço indisponível                | O serviço solicitado não está temporariamente disponível                                                  |

## Formato padrão da resposta

Todos os erros terão um corpo de resposta padrão com dois campos, `código` e `mensagem`. Podem ser usados mais campos, mas são opcionais.

## Exemplos

Esta é a forma mais simples do corpo de resposta de um erro; os clientes podem confiar que estes campos estarão presentes em todos os erros.

### Respostas de erro - Exemplo 1 (Base)

```json
{
  "code": 429,
  "message": "Excedeu o seu número de pedidos. Tente novamente mais tarde"
}
```

O exemplo seguinte tem, além dos campos padrão, campos para erros associados a este pedido específico.

### Respostas de erro - Exemplo 2 (Mais complexo)

```json
{
  "code": 422,
  "message": "Entidade não processável",
  "cause": "A validação falhou",
  "errors": [
    {
      "resource": "Issue",
      "field": "title",
      "code": "missing_field"
    },
    ...
  ]
}
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.exoclick.com/api/pt/api-publica-exoclick/api-manual-errors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.