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

# Erros

> Um único envelope de erro, seus códigos e os motivos nas rotas de parceiro.

Todo erro usa um único envelope:

```json theme={null}
{
  "error": {
    "code": "conflict",
    "message": "Request conflicts with an earlier operation.",
    "correlation_id": "0af7651916cd43dd8448eb211c80319c",
    "reason": "stale_totals"
  }
}
```

* `code` é estável e legível por máquina.
* `message` é uma frase em inglês, estável e segura. Ela nunca traz o texto do erro interno.
* `correlation_id` tem 32 caracteres hexadecimais. Informe esse valor quando falar com a gente.
* `reason` é opcional e vem de uma lista fechada para cada operação.

## Códigos

`invalid_request`, `request_too_large`, `unauthenticated`, `not_found`, `conflict`, `unprocessable`, `operation_disabled`, `rate_limited`, `forbidden`, `dependency_unavailable`, `internal`, `deadline_exceeded`, `method_not_allowed`.

## Motivos nas rotas de parceiro

| Status | Código | Motivo | Significado |
| - | - | - | - |
| 400 | `invalid_request` | nenhum | Um corpo malformado: um membro desconhecido ou repetido, um valor do tipo errado ou fora do intervalo, ou, nos totais de voo, um `as_of` que não está em RFC 3339 ou está mais de 5 minutos à frente do relógio do servidor. |
| 400 | `invalid_request` | `invalid_grant` | O código não abre um grant para este parceiro, verifier e URI de redirecionamento. Reinicie o consentimento. |
| 403 | `forbidden` | `scope_missing` | O grant ou o token não tem o scope que esta rota atende. |
| 404 | `not_found` | nenhum | O grant ou o certificado está revogado, é desconhecido, está malformado ou é de outro parceiro. |
| 409 | `conflict` | `stale_totals` | O `as_of` de um envio de totais de voo é anterior ao último envio aceito do grant. Nada foi aplicado. |
| 409 | `conflict` | `webhook_not_configured` | Não há URL de webhook registrada, ela não é https, ou não há secret registrado. Peça ao MyPilotIndex para configurá-los. |
| 422 | `unprocessable` | `hours_rule` | Os totais, combinados com o registro do piloto, quebrariam as regras de horas dele. Nada foi aplicado. |
| 429 | `rate_limited` | `rate_limited` | A cota diária do parceiro acabou. |
| 429 | `rate_limited` | `push_throttled` | O último envio de totais de voo aceito do grant foi feito há menos de 15 minutos. |

Outros status que você pode encontrar: `401` para um token ausente ou inválido, `405` para um método que o caminho não aceita, `413` para um corpo acima do limite da rota, e `500`, `503` e `504` para falhas do nosso lado. Repita `429` depois do tempo indicado em `Retry-After`, e `500`, `503` e `504` com um intervalo crescente. Não repita `400`, `401`, `403`, `404`, `405`, `409`, `413` ou `422` sem mudanças: corrija a requisição ou, no caso de `409 stale_totals`, envie o estado atual do logbook.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.