Referencia de la API

Mantenido por: Aether365 Team Audiencia: Desarrolladores e ingenieros DevOps Alcance: Visión general de la API REST de Aether365, URL base y formato de respuesta

La API de Aether365 te permite acceder programaticamente a los datos de análisis, lanzar análisis, gestionar tenants y dirigir AI Pilot: generar, revisar y aplicar remediación automatizada, leer señales de riesgo de identidad y reforzar políticas.

Grupos de endpoints

Área	Qué cubre
Scans	Lanzar y listar análisis de cumplimiento y exposición
Results	Leer hallazgos individuales de un análisis
AI Pilot	Generar, revisar y aplicar planes de remediación automatizados
Threat Alerts	Señales de riesgo de identidad y contención de usuario con un clic
Policies	Leer la postura de las políticas y reforzar las políticas de la lista de permitidos
Tenants	Leer y actualizar el perfil del tenant
Connections	Gestionar los tenants de Microsoft 365 conectados
Scheduled Scans	Automatizar análisis recurrentes

URL base

https://api.aether365.io

Todos los endpoints son relativos a esta URL base.

Autenticación

La API utiliza autenticación Bearer token. Incluye un token JWT válido en la cabecera Authorization de cada solicitud:

Authorization: Bearer <token>

Los tokens son emitidos por el sistema de autenticación de Aether365. Consulta Autenticación para más detalles sobre cómo obtener un token.

Formato de respuesta

Todas las respuestas de la API utilizan una estructura JSON consistente.

Respuesta de éxito

{
  "success": true,
  "data": {}
}

Para endpoints de lista:

{
  "success": true,
  "data": [],
  "meta": {
    "total": 142,
    "page": 1,
    "limit": 20
  }
}

Para endpoints de acción (trigger, delete):

{
  "success": true,
  "data": null
}

Respuesta de error

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

Códigos de estado HTTP

Código	Significado
200	Éxito
201	Recurso creado
400	Solicitud invalida - parámetros ausentes o mal formateados
401	Se requiere autenticación o el token no es válido
403	Acceso denegado - violación del aislamiento de tenant
404	Recurso no encontrado
409	Conflicto - por ejemplo, ya hay un análisis en ejecución
429	Límite del plan alcanzado
500	Error interno del servidor

Códigos de error

Código	Descripción
AUTH_MISSING_TOKEN	Cabecera Authorization no presente
AUTH_INVALID_TOKEN	No se pudo verificar el token
AUTH_EXPIRED_TOKEN	El token ha expirado
TENANT_NOT_FOUND	El tenant no existe
TENANT_NOT_CONNECTED	El consent de Microsoft no se ha completado
SCAN_NOT_FOUND	El ID de análisis no existe
SCAN_ALREADY_RUNNING	Ya hay un análisis en curso para este tenant
SCAN_PLAN_LIMIT_REACHED	La cuota de análisis del plan actual se ha agotado
VALIDATION_ERROR	El cuerpo de la solicitud o los parámetros son inválidos
INTERNAL_ERROR	Error inesperado del servidor

Limites de tasa

La API tiene un límite de 120 solicitudes por minuto. Si se supera el límite, se devuelve 429 Too Many Requests. La cabecera Retry-After indica cuantos segundos hay que esperar antes de reintentar.