# Errores y códigos de estado

Gestiona errores mediante estado HTTP, código estructurado y `x-request-id`, sin registrar credenciales ni contenido de solicitudes.

| Estado | Significado | Acción |
| --- | --- | --- |
| `400` | Petición inválida | Corrige el contenido; no repitas sin cambios. |
| `401` | Fallo de autenticación | Renueva o reemplaza el token de cuenta. |
| `403` | Función o plan denegado | Comprueba autorización y modelo solicitado. |
| `404` | Ruta o recurso ausente | Verifica ruta `/v1` e identificador. |
| `429` | Límite alcanzado | Respeta la espera y reduce concurrencia. |
| `5xx` | Fallo del servicio | Reintenta solo trabajo seguro con espera limitada y variación aleatoria. |

Las rutas desconocidas devuelven `NOT_FOUND`; las validaciones, `VALIDATION_ERROR`; los fallos inesperados, INTERNAL_ERROR. Los mensajes del proveedor pueden variar: no bases el control del cliente en texto libre.

**Resultado esperado:** el cliente corrige errores permanentes o realiza reintentos limitados conservando el identificador para soporte.