Errores/Codigos de Error

Codigos de Error

Referencia de todos los codigos de error HTTP y personalizados de la API.

Errores HTTP

400Bad Request

Datos de entrada invalidos

Solucion: Revisa el formato del body y los parametros requeridos

401Unauthorized

Token faltante o invalido

Solucion: Verifica tu API Key y el header Authorization

403Forbidden

Sin permisos suficientes

Solucion: Genera una API Key con los scopes necesarios

404Not Found

Recurso no encontrado

Solucion: Verifica el ID del recurso en la URL

409Conflict

Conflicto con estado actual

Solucion: El recurso ya existe o hay un conflicto de version

422Unprocessable Entity

Logica de negocio invalida

Solucion: Los datos son validos pero no cumplen reglas de negocio

429Too Many Requests

Rate limit excedido

Solucion: Espera y reintenta con backoff exponencial

500Internal Server Error

Error interno del servidor

Solucion: Reintenta. Si persiste, contacta soporte

502Bad Gateway

Error en servicio externo

Solucion: Error temporal. Reintenta en unos segundos

503Service Unavailable

Servicio no disponible

Solucion: Mantenimiento. Revisa status.astrapp.lat

Errores personalizados

VALIDATION_ERROR400Campos invalidos en el body

UNAUTHORIZED401No autenticado

FORBIDDEN403Sin permisos

NOT_FOUND404Recurso no existe

RATE_LIMIT_EXCEEDED429Limite de requests excedido

SUBSCRIPTION_LIMIT_EXCEEDED403Limite del plan excedido

TRAINING_FAILED500Error durante entrenamiento

DATASET_VALIDATION_FAILED422Dataset con errores

MODEL_NOT_READY422Modelo aun no esta listo

Formato de error

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "details": [
      {
        "field": "email",
        "message": "Email is required"
      }
    ],
    "request_id": "req_abc123",
    "timestamp": "2024-12-23T10:30:00Z"
  }
}

Troubleshooting