API za povezave

Povezave predstavljajo povezane najemnike Microsoft 365. Vsaka povezava ustreza Microsoftovemu najemniku (identificiranemu z msTenantId), ki mu je bilo podeljeno soglasje skrbnika.

Seznam povezav

Vrne vse najemnike Microsoft 365, povezane z overjenim računom.

GET /tenants/me/connections

Primer zahteve

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

Primer odgovora

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

Polja odgovora

Polje	Vrsta	Opis
id	string	Identifikator povezave
msTenantId	string	Identifikator najemnika Microsoft Entra (GUID)
label	string	Prikazna oznaka, dodeljena med povezavo
connectedAt	string	Časovni žig ISO 8601, ko je bil najemnik povezan
isPrimary	boolean	Ali je to trenutno aktivni najemnik

---

Aktivacija povezave

Nastavi povezanega najemnika kot aktivnega najemnika. Pogledi nadzorne plošče in klici API brez izrecnega filtra najemnika delujejo na aktivnem najemniku.

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

Parametri poti

Parameter	Vrsta	Opis
connectionId	string	Identifikator povezave za aktivacijo

Primer zahteve

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

Primer odgovora

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

---

Odstranitev povezave

Prekine povezavo z najemnikom Microsoft 365. Ustavi prihodnja skeniranja za tega najemnika. Obstoječi podatki skeniranja se hranijo v skladu s politiko hrambe.

DELETE /tenants/me/connections/{connectionId}

WARNING

Tega dejanja ni mogoče razveljaviti. Ponovna povezava najemnika zahteva ponovitev postopka soglasja skrbnika.

Parametri poti

Parameter	Vrsta	Opis
connectionId	string	Identifikator povezave za odstranitev

Primer zahteve

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

Primer odgovora

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

Napake

Koda	HTTP	Opis
CONNECTION_NOT_FOUND	404	Za tega najemnika ne obstaja povezava s tem identifikatorjem
CANNOT_REMOVE_LAST_CONNECTION	409	Ni mogoče odstraniti edine preostale povezave