API підключень

Підключення представляють зв'язані Microsoft 365 tenant'и. Кожне підключення відповідає Microsoft tenant'у (ідентифікованому за msTenantId), якому було надано адміністративну згоду.

Список підключень

Повертає всі Microsoft 365 tenant'и, підключені до автентифікованого облікового запису.

GET /tenants/me/connections

Приклад запиту

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

Приклад відповіді

{
  "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
    }
  ]
}

Поля відповіді

Поле	Тип	Опис
id	string	Ідентифікатор підключення
msTenantId	string	ID Microsoft Entra tenant'у (GUID)
label	string	Назва, призначена під час підключення
connectedAt	string	Часова мітка ISO 8601 підключення tenant'у
isPrimary	boolean	Чи є цей tenant поточним активним

---

Активація підключення

Встановлює підключений tenant як активний. Відображення dashboard та API-запити без явного фільтра tenant'у працюють з активним tenant'ом.

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

Параметри шляху

Параметр	Тип	Опис
connectionId	string	ID підключення для активації

Приклад запиту

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

Приклад відповіді

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

---

Видалення підключення

Від'єднує Microsoft 365 tenant. Зупиняє майбутні сканування для цього tenant'у. Існуючі дані сканувань зберігаються відповідно до політики збереження.

DELETE /tenants/me/connections/{connectionId}

WARNING

Цю дію неможливо скасувати. Повторне підключення tenant'у вимагає повторного проходження потоку адміністративної згоди.

Параметри шляху

Параметр	Тип	Опис
connectionId	string	ID підключення для видалення

Приклад запиту

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

Приклад відповіді

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

Помилки

Код	HTTP	Опис
CONNECTION_NOT_FOUND	404	Підключення з таким ID не існує для цього tenant'у
CANNOT_REMOVE_LAST_CONNECTION	409	Неможливо видалити єдине залишене підключення