Tilkoblinger-API

Vedlikeholdt av: Aether365 Team Malgruppe: Utviklere Omfang: Tilkoblinger-API-endepunkter - administrere Microsoft 365-leietakertilkoblinger

Tilkoblinger representerer koblede Microsoft 365-leietakere. Hver tilkobling tilsvarer en Microsoft-leietaker (identifisert av sin msTenantId) som har fatt administratorsamtykke.

Liste over tilkoblinger

Returnerer alle Microsoft 365-leietakere som er koblet til den autentiserte kontoen.

GET /tenants/me/connections

Eksempelforespørsel

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

Eksempelrespons

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

Responsfelt

Felt	Type	Beskrivelse
id	string	Tilkoblingsidentifikator
msTenantId	string	Microsoft Entra-leietaker-ID (GUID)
label	string	Visningsetikett tildelt under tilkobling
connectedAt	string	ISO 8601-tidsstempel for nar leietakeren ble koblet til
isPrimary	boolean	Om dette er den aktive leietakeren

---

Aktiver en tilkobling

Setter en tilkoblet leietaker som aktiv leietaker. Dashboardvisninger og API-kall uten eksplisitt leietakerfilter opererer pa den aktive leietakeren.

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

Baneparametere

Parameter	Type	Beskrivelse
connectionId	string	Tilkoblings-IDen som skal aktiveres

Eksempelforespørsel

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

Eksempelrespons

{
  "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 tilkobling

Kobler fra en Microsoft 365-leietaker. Stopper fremtidige skanninger for denne leietakeren. Eksisterende skannedata oppbevares i henhold til oppbevaringspolicyen.

DELETE /tenants/me/connections/{connectionId}

WARNING

Denne handlingen kan ikke angres. A koble til leietakeren pa nytt krever at du gar gjennom administratorsamtykkeflyten igjen.

Baneparametere

Parameter	Type	Beskrivelse
connectionId	string	Tilkoblings-IDen som skal fjernes

Eksempelforespørsel

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

Eksempelrespons

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

Feil

Kode	HTTP	Beskrivelse
CONNECTION_NOT_FOUND	404	Ingen tilkobling med denne IDen eksisterer for denne leietakeren
CANNOT_REMOVE_LAST_CONNECTION	409	Kan ikke fjerne den eneste gjenvarende tilkoblingen