Csatlakozások API

A csatlakozások az összekapcsolt Microsoft 365 bérlőket képviselik. Minden csatlakozás egy Microsoft bérlőnek felel meg (msTenantId által azonosítva), amelyhez admin consent lett megadva.

Csatlakozások listázása

Az autentikált fiókhoz csatlakoztatott összes Microsoft 365 bérlőt adja vissza.

GET /tenants/me/connections

Példa kérés

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

Példa válasz

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

Válasz mezők

Mező	Típus	Leírás
id	string	Csatlakozás-azonosító
msTenantId	string	Microsoft Entra bérlő-azonosító (GUID)
label	string	Csatlakozáskor hozzárendelt megjelenítési címke
connectedAt	string	ISO 8601 időbélyeg a bérlő csatlakozásáról
isPrimary	boolean	Ez-e a jelenleg aktív bérlő

---

Csatlakozás aktiválása

Egy csatlakoztatott bérlőt állít be aktív bérlőként. Az irányítópult nézetei és a kifejezett bérlő szűrő nélküli API hívások az aktív bérlő adatain működnek.

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

Útvonal paraméterek

Paraméter	Típus	Leírás
connectionId	string	Az aktiválandó csatlakozás-azonosító

Példa kérés

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

Példa válasz

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

---

Csatlakozás eltávolítása

Leválasztja a Microsoft 365 bérlőt. Leállítja a jövőbeli vizsgálatokat ehhez a bérlőhöz. A meglévő vizsgálati adatok a megőrzési szabályzat szerint megmaradnak.

DELETE /tenants/me/connections/{connectionId}

WARNING

Ez a művelet nem vonható vissza. A bérlő újracsatlakoztatásához az admin consent folyamatot újra végig kell járni.

Útvonal paraméterek

Paraméter	Típus	Leírás
connectionId	string	Az eltávolítandó csatlakozás-azonosító

Példa kérés

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

Példa válasz

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

Hibák

Kód	HTTP	Leírás
CONNECTION_NOT_FOUND	404	Nem létezik ilyen azonosítójú csatlakozás a bérlőhöz
CANNOT_REMOVE_LAST_CONNECTION	409	Az egyetlen megmaradt csatlakozás nem távolítható el