Forbindelser API

Forbindelser repræsenterer tilknyttede Microsoft 365 tenants. Hver forbindelse svarer til en Microsoft-tenant (identificeret ved dens msTenantId), der har fået admin consent.

List forbindelser

Returnerer alle Microsoft 365 tenants forbundet til den autentificerede konto.

GET /tenants/me/connections

Eksempel på forespørgsel

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

Eksempel på svar

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

Svarfelter

Felt	Type	Beskrivelse
id	string	Forbindelsesidentifikator
msTenantId	string	Microsoft Entra tenant-ID (GUID)
label	string	Visningsetiket tildelt under forbindelsen
connectedAt	string	ISO 8601-tidsstempel for, hvornår tenanten blev forbundet
isPrimary	boolean	Om dette er den aktuelt aktive tenant

---

Aktiver en forbindelse

Sætter en forbundet tenant som den aktive tenant. Dashboard-visninger og API-kald uden et eksplicit tenant-filter opererer på den aktive tenant.

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

Sti-parametre

Parameter	Type	Beskrivelse
connectionId	string	Forbindelses-ID'et, der skal aktiveres

Eksempel på forespørgsel

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

Eksempel på svar

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

---

Fjern en forbindelse

Afbryder en Microsoft 365 tenant. Stopper fremtidige scanninger for denne tenant. Eksisterende scanningsdata opbevares i henhold til opbevaringspolitikken.

DELETE /tenants/me/connections/{connectionId}

WARNING

Denne handling kan ikke fortrydes. Genforbindelse af tenanten kræver at gennemgå admin consent-flowet igen.

Sti-parametre

Parameter	Type	Beskrivelse
connectionId	string	Forbindelses-ID'et, der skal fjernes

Eksempel på forespørgsel

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

Eksempel på svar

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

Fejl

Kode	HTTP	Beskrivelse
CONNECTION_NOT_FOUND	404	Ingen forbindelse med dette ID eksisterer for denne tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Kan ikke fjerne den eneste tilbageværende forbindelse