# 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.