Anslutnings-API

Underhålls av: Aether365 Team Målgrupp: Utvecklare Omfattning: Anslutnings-API-endpoints - hantera Microsoft 365-tenant-anslutningar

Anslutningar representerar länkade Microsoft 365-tenants. Varje anslutning motsvarar en Microsoft-tenant (identifierad av dess msTenantId) som har beviljats administratörssamtycke.

Lista anslutningar

Returnerar alla Microsoft 365-tenants anslutna till det autentiserade kontot.

GET /tenants/me/connections

Exempelbegäran

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

Exempelsvar

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

Svarsfält

Fält	Typ	Beskrivning
id	string	Anslutningsidentifierare
msTenantId	string	Microsoft Entra tenant-ID (GUID)
label	string	Visningsetikett tilldelad vid anslutning
connectedAt	string	ISO 8601-tidsstämpel när tenanten anslöts
isPrimary	boolean	Om detta är den för tillfället aktiva tenanten

---

Aktivera en anslutning

Ställer in en ansluten tenant som den aktiva tenanten. Instrumentpanelsvyer och API-anrop utan explicit tenant-filter opererar på den aktiva tenanten.

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

Sökvägsparametrar

Parameter	Typ	Beskrivning
connectionId	string	Anslutnings-ID:t att aktivera

Exempelbegäran

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

Exempelsvar

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

---

Ta bort en anslutning

Kopplar bort en Microsoft 365-tenant. Stoppar framtida skanningar för denna tenant. Befintliga skanningsdata sparas enligt lagringspolicyn.

DELETE /tenants/me/connections/{connectionId}

WARNING

Denna åtgärd kan inte ångras. Att återansluta tenanten kräver att gå igenom samtyckesflödet igen.

Sökvägsparametrar

Parameter	Typ	Beskrivning
connectionId	string	Anslutnings-ID:t att ta bort

Exempelbegäran

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

Exempelsvar

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

Fel

Kod	HTTP	Beskrivning
CONNECTION_NOT_FOUND	404	Ingen anslutning med detta ID finns för denna tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Kan inte ta bort den enda kvarvarande anslutningen