API de Connections

Mantenido por: Aether365 Team Audiencia: Desarrolladores Alcance: Endpoints de la API de Connections - gestión de conexiones de tenants de Microsoft 365

Las conexiones representan tenants de Microsoft 365 vinculados. Cada conexión corresponde a un tenant de Microsoft (identificado por su msTenantId) al que se le ha otorgado admin consent.

Listar conexiones

Devuelve todos los tenants de Microsoft 365 conectados a la cuenta autenticada.

GET /tenants/me/connections

Solicitud de ejemplo

curl https://api.aether365.io/tenants/me/connections \
  -H "Authorization: Bearer <token>"

Respuesta de ejemplo

{
  "success": true,
  "data": [
    {
      "id": "conn_abc123",
      "msTenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "label": "Contoso Production",
      "connectedAt": "2026-02-01T09:00:00Z",
      "isPrimary": true
    },
    {
      "id": "conn_def456",
      "msTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "label": "Contoso Staging",
      "connectedAt": "2026-03-15T14:30:00Z",
      "isPrimary": false
    }
  ]
}

Campos de respuesta

Campo	Tipo	Descripción
id	string	Identificador de la conexión
msTenantId	string	ID del tenant de Microsoft Entra (GUID)
label	string	Etiqueta para mostrar asignada durante la conexión
connectedAt	string	Marca de tiempo ISO 8601 de cuando se conectó el tenant
isPrimary	boolean	Si este es el tenant activo actualmente

---

Activar una conexión

Establece un tenant conectado como el tenant activo. Las vistas del dashboard y las llamadas a la API sin un filtro de tenant explícito operan sobre el tenant activo.

POST /tenants/me/connections/{connectionId}/activate

Parámetros de ruta

Parámetro	Tipo	Descripción
connectionId	string	ID de la conexión a activar

Solicitud de ejemplo

curl -X POST https://api.aether365.io/tenants/me/connections/conn_def456/activate \
  -H "Authorization: Bearer <token>"

Respuesta de ejemplo

{
  "success": true,
  "data": {
    "id": "conn_def456",
    "msTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
    "label": "Contoso Staging",
    "connectedAt": "2026-03-15T14:30:00Z",
    "isPrimary": true
  }
}

---

Eliminar una conexión

Desconecta un tenant de Microsoft 365. Detiene los análisis futuros para este tenant. Los datos de análisis existentes se conservan según la política de retención.

DELETE /tenants/me/connections/{connectionId}

WARNING

Esta acción no se puede deshacer. Reconectar el tenant requiere pasar de nuevo por el flujo de admin consent.

Parámetros de ruta

Parámetro	Tipo	Descripción
connectionId	string	ID de la conexión a eliminar

Solicitud de ejemplo

curl -X DELETE https://api.aether365.io/tenants/me/connections/conn_def456 \
  -H "Authorization: Bearer <token>"

Respuesta de ejemplo

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

Errores

Código	HTTP	Descripción
CONNECTION_NOT_FOUND	404	No existe una conexión con este ID para este tenant
CANNOT_REMOVE_LAST_CONNECTION	409	No se puede eliminar la única conexión restante