Savienojumu API

Savienojumi attēlo piesaistītos Microsoft 365 nomniekus. Katrs savienojums atbilst Microsoft nomniekam (identificēts pēc tā msTenantId), kam ir piešķirta administratora piekrišana.

Savienojumu saraksts

Atgriež visus Microsoft 365 nomniekus, kas savienoti ar autentificēto kontu.

GET /tenants/me/connections

Pieprasījuma piemērs

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

Atbildes piemērs

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

Atbildes lauki

Lauks	Tips	Apraksts
id	string	Savienojuma identifikators
msTenantId	string	Microsoft Entra nomnieka ID (GUID)
label	string	Attēlošanas etiķete, kas piešķirta savienošanas laikā
connectedAt	string	ISO 8601 laikspiedols, kad nomnieks tika savienots
isPrimary	boolean	Vai šis ir pašreiz aktīvais nomnieks

---

Aktivizēt savienojumu

Iestata savienoto nomnieku kā aktīvo nomnieku. Informācijas paneļa skati un API izsaukumi bez tieša nomnieka filtra darbojas ar aktīvo nomnieku.

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

Ceļa parametri

Parametrs	Tips	Apraksts
connectionId	string	Aktivizējamā savienojuma ID

Pieprasījuma piemērs

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

Atbildes piemērs

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

---

Noņemt savienojumu

Atvieno Microsoft 365 nomnieku. Aptur turpmākās skenēšanas šim nomniekam. Esošie skenēšanas dati tiek saglabāti saskaņā ar saglabāšanas politiku.

DELETE /tenants/me/connections/{connectionId}

WARNING

Šo darbību nevar atsaukt. Nomnieka atkārtota savienošana prasa atkārtotu administratora piekrišanas plūsmu.

Ceļa parametri

Parametrs	Tips	Apraksts
connectionId	string	Noņemamā savienojuma ID

Pieprasījuma piemērs

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

Atbildes piemērs

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

Kļūdas

Kods	HTTP	Apraksts
CONNECTION_NOT_FOUND	404	Savienojums ar šo ID šim nomniekam nepastāv
CANNOT_REMOVE_LAST_CONNECTION	409	Nevar noņemt vienīgo atlikušo savienojumu