API Conexiuni

Conexiunile reprezintă tenant-uri Microsoft 365 legate. Fiecare conexiune corespunde unui tenant Microsoft (identificat prin msTenantId) care a primit admin consent.

Listarea conexiunilor

Returnează toate tenant-urile Microsoft 365 conectate la contul autentificat.

GET /tenants/me/connections

Exemplu de cerere

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

Exemplu de răspuns

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

Câmpuri răspuns

Câmp	Tip	Descriere
id	string	Identificator conexiune
msTenantId	string	ID tenant Microsoft Entra (GUID)
label	string	Etichetă afișată atribuită la conectare
connectedAt	string	Marcaj temporal ISO 8601 când tenant-ul a fost conectat
isPrimary	boolean	Dacă acesta este tenant-ul activ curent

---

Activarea unei conexiuni

Setează un tenant conectat ca tenant activ. Vizualizările din dashboard și apelurile API fără un filtru explicit de tenant operează pe tenant-ul activ.

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

Parametri de cale

Parametru	Tip	Descriere
connectionId	string	ID-ul conexiunii de activat

Exemplu de cerere

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

Exemplu de răspuns

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

---

Eliminarea unei conexiuni

Deconectează un tenant Microsoft 365. Oprește scanările viitoare pentru acest tenant. Datele de scanare existente sunt păstrate conform politicii de retenție.

DELETE /tenants/me/connections/{connectionId}

WARNING

Această acțiune nu poate fi anulată. Reconectarea tenant-ului necesită parcurgerea din nou a fluxului de admin consent.

Parametri de cale

Parametru	Tip	Descriere
connectionId	string	ID-ul conexiunii de eliminat

Exemplu de cerere

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

Exemplu de răspuns

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

Erori

Cod	HTTP	Descriere
CONNECTION_NOT_FOUND	404	Nu există nicio conexiune cu acest ID pentru acest tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Nu se poate elimina singura conexiune rămasă