Erros e códigos de estado

Lide com falhas Foxora API por estado HTTP, código de erro estruturado e x-request-id, mantendo as credenciais e o conteúdo de prompt fora dos registos.

Estado	Significado	Ação do cliente
`400`	Pedido inválido	Corrija a carga útil; não tente novamente inalterado.
`401`	Falha na autenticação	Atualize ou substitua o token da conta.
`403`	Recurso ou plano negado	Verifique o direito e o modelo solicitado.
`404`	Rota ou recurso em falta	Verifique o caminho e o identificador `/v1`.
`429`	Limite de solicitação atingido	Aguarde a orientação de reposição e reduza a simultaneidade.
`5xx`	Falha no serviço	Tente novamente o trabalho seguro com espera e instabilidade limitadas.

Rotas desconhecidas retornam NOT_FOUND; falhas de validação retornam VALIDATION_ERROR; falhas inesperadas retornam INTERNAL_ERROR. As mensagens específicas do upstream podem variar, por isso não crie um fluxo de controlo a partir da prosa.

Resultado esperado: o cliente corrige um erro de pedido permanente ou executa uma nova tentativa limitada, mantendo o identificador de pedido para suporte.