API pripojení

Pripojenia reprezentujú prepojené Microsoft 365 tenanty. Každé pripojenie zodpovedá tenantu Microsoftu (identifikovanému jeho msTenantId), ktorému bol udelený administrátorský súhlas.

Zoznam pripojení

Vráti všetky Microsoft 365 tenanty pripojené k autentifikovanému účtu.

GET /tenants/me/connections

Príklad požiadavky

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

Príklad odpovede

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

Polia odpovede

Pole	Typ	Popis
id	string	Identifikátor pripojenia
msTenantId	string	ID tenantu Microsoft Entra (GUID)
label	string	Zobrazovaný štítok priradený počas pripojenia
connectedAt	string	Časová pečiatka ISO 8601 pripojenia tenantu
isPrimary	boolean	Či ide o aktuálne aktívneho tenanta

---

Aktivácia pripojenia

Nastaví pripojeného tenanta ako aktívneho. Zobrazenia v dashboarde a volania API bez explicitného filtra tenanta pracujú s aktívnym tenantom.

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

Parametre cesty

Parameter	Typ	Popis
connectionId	string	ID pripojenia na aktiváciu

Príklad požiadavky

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

Príklad odpovede

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

---

Odstránenie pripojenia

Odpojí Microsoft 365 tenanta. Zastaví budúce skeny pre tohto tenanta. Existujúce dáta skenov sa uchovávajú podľa politiky uchovávania.

DELETE /tenants/me/connections/{connectionId}

WARNING

Túto akciu nie je možné vrátiť späť. Opätovné pripojenie tenantu vyžaduje prejsť tokom administrátorského súhlasu znovu.

Parametre cesty

Parameter	Typ	Popis
connectionId	string	ID pripojenia na odstránenie

Príklad požiadavky

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

Príklad odpovede

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

Chyby

Kód	HTTP	Popis
CONNECTION_NOT_FOUND	404	Pre tohto tenanta neexistuje pripojenie s týmto ID
CANNOT_REMOVE_LAST_CONNECTION	409	Nie je možné odstrániť posledné zostávajúce pripojenie