Yhteydet-API

Ylläpitäjä: Aether365-tiimi Kohderyhmä: Kehittäjät Laajuus: Yhteys-API-päätepisteet - Microsoft 365 -vuokralaisyhteyksien hallinta

Yhteydet edustavat linkitettyjä Microsoft 365 -vuokralaisia. Jokainen yhteys vastaa Microsoft-vuokralaista (tunnistettu msTenantId:lla), jolle on myönnetty hallintasuostumus.

Listaa yhteydet

Palauttaa kaikki todennettuun tiliin yhdistetyt Microsoft 365 -vuokralaiset.

GET /tenants/me/connections

Esimerkkipyyntö

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 kentät

Kenttä	Tyyppi	Kuvaus
id	string	Yhteyden tunniste
msTenantId	string	Microsoft Entra -vuokralaistunnus (GUID)
label	string	Yhdistämisen yhteydessä määritetty näyttötunniste
connectedAt	string	ISO 8601 -aikaleima vuokralaisen yhdistämisestä
isPrimary	boolean	Onko tämä tällä hetkellä aktiivinen vuokralainen

---

Aktivoi yhteys

Asettaa yhdistetyn vuokralaisen aktiiviseksi vuokralaiseksi. Hallintapaneelin näkymät ja API-kutsut ilman erillistä vuokralaissuodatinta kohdistuvat aktiiviseen vuokralaiseen.

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

Polkuparametrit

Parametri	Tyyppi	Kuvaus
connectionId	string	Aktivoitavan yhteyden tunniste

Esimerkkipyyntö

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 tälle vuokralaiselle. Olemassa olevat skannaustiedot säilytetään säilytyskäytännön mukaisesti.

DELETE /tenants/me/connections/{connectionId}

WARNING

Tätä toimintoa ei voi perua. Vuokralaisen uudelleenyhdistäminen vaatii hallintasuostumusprosessin suorittamisen uudelleen.

Polkuparametrit

Parametri	Tyyppi	Kuvaus
connectionId	string	Poistettavan yhteyden tunniste

Esimerkkipyyntö

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	Tällä tunnuksella ei ole yhteyttä tälle vuokralaiselle
CANNOT_REMOVE_LAST_CONNECTION	409	Ainoaa jäljellä olevaa yhteyttä ei voi poistaa