API połączeń

Autor: Zespół Aether365 Odbiorcy: Deweloperzy Zakres: Endpointy API połączeń - zarządzanie połączeniami z tenantami Microsoft 365

Połączenia reprezentują powiązane tenanty Microsoft 365. Każde połączenie odpowiada tenantowi Microsoft (identyfikowanemu przez msTenantId), któremu udzielono admin consent.

Lista połączeń

Zwraca wszystkie tenanty Microsoft 365 podłączone do uwierzytelnionego konta.

GET /tenants/me/connections

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Pola odpowiedzi

Pole	Typ	Opis
id	string	Identyfikator połączenia
msTenantId	string	Identyfikator tenanta Microsoft Entra (GUID)
label	string	Etykieta wyświetlana nadana podczas podłączania
connectedAt	string	Znacznik czasu ISO 8601 podłączenia tenanta
isPrimary	boolean	Czy jest to aktualnie aktywny tenant

---

Aktywacja połączenia

Ustawia podłączonego tenanta jako aktywnego. Widoki dashboardu i wywołania API bez jawnego filtra tenanta działają na aktywnym tenancie.

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

Parametry ścieżki

Parametr	Typ	Opis
connectionId	string	Identyfikator połączenia do aktywacji

Przykładowe żądanie

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

Przykładowa odpowiedź

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

---

Usunięcie połączenia

Odłącza tenanta Microsoft 365. Zatrzymuje przyszłe skany dla tego tenanta. Istniejące dane skanów są przechowywane zgodnie z polityką retencji.

DELETE /tenants/me/connections/{connectionId}

WARNING

Tej operacji nie można cofnąć. Ponowne podłączenie tenanta wymaga ponownego przejścia przez proces admin consent.

Parametry ścieżki

Parametr	Typ	Opis
connectionId	string	Identyfikator połączenia do usunięcia

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Błędy

Kod	HTTP	Opis
CONNECTION_NOT_FOUND	404	Nie istnieje połączenie o tym ID dla tego tenanta
CANNOT_REMOVE_LAST_CONNECTION	409	Nie można usunąć jedynego pozostałego połączenia