API пiдключень

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

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

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

GET /tenants/me/connections

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

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

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

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

Поля вiдповiдi

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

---

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

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

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

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

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

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

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

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

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

---

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

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

DELETE /tenants/me/connections/{connectionId}

WARNING

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

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

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

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

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

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

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

Помилки

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