> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onbeef.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Trate erros da API

> Consulte os códigos HTTP e o formato das respostas de erro.

Verifique o status HTTP antes de processar o corpo da resposta.

## Códigos HTTP

| Código | Significado                           | Ação                                   |
| ------ | ------------------------------------- | -------------------------------------- |
| `200`  | Requisição concluída.                 | Processe a resposta.                   |
| `202`  | Requisição aceita para processamento. | Aguarde a próxima etapa do fluxo.      |
| `204`  | Requisição concluída sem corpo.       | Não tente interpretar JSON.            |
| `400`  | Requisição inválida.                  | Revise os campos enviados.             |
| `401`  | Credencial ou token inválido.         | Obtenha outro token e tente novamente. |
| `403`  | Integração sem permissão.             | Confirme a ativação da integração.     |
| `404`  | Rota ou recurso não encontrado.       | Verifique a URL e os IDs.              |
| `429`  | Limite de requisições excedido.       | Aguarde antes de tentar novamente.     |
| `503`  | Serviço temporariamente indisponível. | Tente novamente depois.                |

## Formato padrão

A maioria dos erros retorna:

```json theme={null}
{
  "title": "Order not found",
  "status": 404
}
```

O endpoint `POST /oauth/token` pode retornar:

```json theme={null}
{
  "error": "invalid_credentials",
  "message": "The client credentials were incorrect."
}
```

## Erro de autenticação

Ao receber `401` em um endpoint protegido:

1. solicite outro token em `POST /oauth/token`;
2. substitua o token usado pela integração;
3. reenvie a requisição original.

Não repita a chamada com o mesmo token inválido.