Yhteydet-API

Yllapitaja: Aether365-tiimi Kohderyhma: Kehittajat Laajuus: Yhteys-API-paatepisteet - Microsoft 365 -vuokralaisyhteyksien hallinta

Yhteydet edustavat linkitettyja Microsoft 365 -vuokralaisia. Jokainen yhteys vastaa Microsoft-vuokralaista (tunnistettu msTenantId:lla), jolle on myonnetty hallintasuostumus.

Listaa yhteydet

Palauttaa kaikki todennettuun tiliin yhdistetyt Microsoft 365 -vuokralaiset.

GET /tenants/me/connections

Esimerkkipyynto

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

Esimerkkivastaus

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

Vastauksen kentat

Kentta	Tyyppi	Kuvaus
id	string	Yhteyden tunniste
msTenantId	string	Microsoft Entra -vuokralaistunnus (GUID)
label	string	Yhdistamisen yhteydessa maaritetty nayttotunniste
connectedAt	string	ISO 8601 -aikaleima vuokralaisen yhdistamisesta
isPrimary	boolean	Onko tama tällä hetkellä aktiivinen vuokralainen

---

Aktivoi yhteys

Asettaa yhdistetyn vuokralaisen aktiiviseksi vuokralaiseksi. Hallintapaneelin nakymat ja API-kutsut ilman erillista vuokralaissuodatinta kohdistuvat aktiiviseen vuokralaiseen.

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

Polkuparametrit

Parametri	Tyyppi	Kuvaus
connectionId	string	Aktivoitavan yhteyden tunniste

Esimerkkipyynto

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

Esimerkkivastaus

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

---

Poista yhteys

Irrottaa Microsoft 365 -vuokralaisen. Lopettaa tulevat skannaukset talle vuokralaiselle. Olemassa olevat skannaustiedot sailytetaan sailytyskaytannon mukaisesti.

DELETE /tenants/me/connections/{connectionId}

WARNING

Tata toimintoa ei voi perua. Vuokralaisen uudelleenyhdistaminen vaatii hallintasuostumusprosessin suorittamisen uudelleen.

Polkuparametrit

Parametri	Tyyppi	Kuvaus
connectionId	string	Poistettavan yhteyden tunniste

Esimerkkipyynto

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

Esimerkkivastaus

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

Virheet

Koodi	HTTP	Kuvaus
CONNECTION_NOT_FOUND	404	Talla tunnuksella ei ole yhteyttä talle vuokralaiselle
CANNOT_REMOVE_LAST_CONNECTION	409	Ainoaa jaljella olevaa yhteyttä ei voi poistaa