Jungčių API

Autorius: Aether365 komanda Auditorija: Kūrėjai Apimtis: Jungčių API galutiniai taškai - Microsoft 365 organizacijų jungčių valdymas

Jungtys atspindi susietas Microsoft 365 organizacijas. Kiekviena jungtis atitinka Microsoft organizaciją (identifikuojamą pagal msTenantId), kuriai buvo suteiktas administratoriaus sutikimas.

Jungčių sąrašas

Grąžina visas Microsoft 365 organizacijas, prijungtas prie autentifikuotos paskyros.

GET /tenants/me/connections

Užklausos pavyzdys

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

Atsakymo pavyzdys

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

Atsakymo laukai

Laukas	Tipas	Aprašymas
id	string	Jungties identifikatorius
msTenantId	string	Microsoft Entra organizacijos ID (GUID)
label	string	Rodoma etiketė, priskirta prijungimo metu
connectedAt	string	ISO 8601 laiko žymė, kada organizacija buvo prijungta
isPrimary	boolean	Ar tai šiuo metu aktyvi organizacija

---

Jungties aktyvavimas

Nustato prijungtą organizaciją kaip aktyvią. Prietaisų skydelio rodiniai ir API užklausos be aiškaus organizacijos filtro veikia su aktyvia organizacija.

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

Kelio parametrai

Parametras	Tipas	Aprašymas
connectionId	string	Aktyvuojamos jungties ID

Užklausos pavyzdys

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

Atsakymo pavyzdys

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

---

Jungties pašalinimas

Atjungia Microsoft 365 organizaciją. Sustabdo būsimus šios organizacijos nuskaitymus. Esami nuskaitymo duomenys saugomi pagal saugojimo politiką.

DELETE /tenants/me/connections/{connectionId}

WARNING

Šio veiksmo atšaukti negalima. Norint pakartotinai prijungti organizaciją, reikia iš naujo atlikti administratoriaus sutikimo procesą.

Kelio parametrai

Parametras	Tipas	Aprašymas
connectionId	string	Šalinamos jungties ID

Užklausos pavyzdys

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

Atsakymo pavyzdys

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

Klaidos

Kodas	HTTP	Aprašymas
CONNECTION_NOT_FOUND	404	Jungtis su šiuo ID neegzistuoja šiai organizacijai
CANNOT_REMOVE_LAST_CONNECTION	409	Negalima pašalinti vienintelės likusios jungties