Códigos de error

Mantenido por: Aether365 Team Audiencia: Desarrolladores y administradores de TI Alcance: Referencia completa de los códigos de error de la API de Aether365

Todos los errores de la API devuelven una estructura JSON consistente:

{
  "success": false,
  "error": {
    "code": "SNAKE_CASE_ERROR_CODE",
    "message": "Human-readable description",
    "details": {}
  }
}

Autenticación

Código	HTTP	Significado	Solución
AUTH_MISSING_TOKEN	401	No hay cabecera Authorization en la solicitud	Incluye Authorization: Bearer <token> en cada solicitud
AUTH_INVALID_TOKEN	401	No se pudo verificar el JWT	Comprueba que el token no este malformado o truncado
AUTH_EXPIRED_TOKEN	401	El JWT ha expirado	Obtener un nuevo token iniciando sesión de nuevo o actualizando la sesión
AUTH_INSUFFICIENT_SCOPE	403	La cuenta autenticada no tiene permiso para esta acción	Verifica que estás usando una cuenta con el rol adecuado

Autorización

Código	HTTP	Significado	Solución
TENANT_ACCESS_DENIED	403	La solicitud intentó acceder a datos de otro tenant	Esto no debería ocurrir en uso normal - contacta con soporte si ves este error
AUTH_INSUFFICIENT_SCOPE	403	Permisos insuficientes para esta acción	Verifica que estás usando una cuenta con el rol adecuado

Tenant

Código	HTTP	Significado	Solución
TENANT_NOT_FOUND	404	No existe una cuenta de tenant para este usuario	Crea una cuenta en app.aether365.io
TENANT_NOT_CONNECTED	400	El admin consent de Microsoft 365 no se ha completado	Conecta un tenant desde Settings > Connections

Análisis

Código	HTTP	Significado	Solución
SCAN_NOT_FOUND	404	El ID de análisis no existe o pertenece a otro tenant	Comprueba el ID del análisis
SCAN_ALREADY_RUNNING	409	Ya hay un análisis en curso para este tenant	Espera a que el análisis actual se complete
SCAN_PLAN_LIMIT_REACHED	429	Cuota de análisis agotada	Espera al siguiente período de facturación o contacta con soporte
SERVICE_UNAVAILABLE	503	La plataforma está en modo mantenimiento	Consulta el estado y reintenta cuando finalice el mantenimiento

Conexiones

Código	HTTP	Significado	Solución
CONNECTION_NOT_FOUND	404	El ID de conexión no existe	Comprueba el ID de la conexión
CANNOT_REMOVE_LAST_CONNECTION	409	No se puede eliminar la única conexión restante	Añade otra conexión antes de eliminar está

Miembros del equipo

Código	HTTP	Significado	Solución
MEMBER_LIMIT_REACHED	429	Límite de miembros alcanzado	Contacta con soporte para añadir más miembros
MEMBER_ALREADY_EXISTS	409	El correo ya tiene una invitación activa o pendiente	Consulta la lista actual de miembros

Análisis programados

Código	HTTP	Significado	Solución
SCAN_PLAN_LIMIT_REACHED	429	Límite de programaciones personalizadas alcanzado	Elimina una programación existente o contacta con soporte

Validación

Código	HTTP	Significado
VALIDATION_ERROR	400	El cuerpo de la solicitud o un parámetro de consulta no es válido. El campo details enumera los campos inválidos.

Errores del servidor

Código	HTTP	Significado	Solución
INTERNAL_ERROR	500	Error inesperado del servidor	Reintenta la solicitud. Si el error persiste, contacta con soporte con el ID de solicitud de las cabeceras de respuesta.

Limites de tasa

Cuando superas el límite de tasa de la API, la API devuelve:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Retry after 60 seconds."
  }
}

Estado HTTP: 429 Too Many Requests Cabecera: Retry-After: 60

Limites de tasa actuales: 120 solicitudes por minuto por clave API.