Erros

Todo erro usa um único envelope:

{
  "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.

Primeiros passos

Conceitos

Referência

Códigos

Motivos nas rotas de parceiro

​Códigos

​Motivos nas rotas de parceiro

Códigos

Motivos nas rotas de parceiro