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	Microsoft Entra tenant ID (GUID)
label	string	Показвано име, зададено при свързването
connectedAt	string	ISO 8601 времеви печат на свързването на tenant-а
isPrimary	boolean	Дали това е текущо активният tenant

---

Активиране на връзка

Задава свързан tenant като активен. Изгледите в таблото и API заявките без изричен филтър по tenant работят върху активния tenant.

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

Параметри на пътя

Параметър	Тип	Описание
connectionId	string	Идентификатор на връзката за активиране

Примерна заявка

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	Идентификатор на връзката за премахване

Примерна заявка

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	Връзка с този идентификатор не съществува за този tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Не може да се премахне единствената оставаща връзка