Erros

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

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.