API Συνδέσεων

Maintained by: Aether365 Team Audience: Developers Scope: Connection API endpoints - managing Microsoft 365 tenant connections

Οι συνδέσεις αντιπροσωπεύουν συνδεδεμένα Microsoft 365 tenants. Κάθε σύνδεση αντιστοιχεί σε ένα Microsoft tenant (αναγνωρίζεται μέσω του msTenantId) στο οποίο έχει χορηγηθεί admin consent.

Λίστα Συνδέσεων

Επιστρέφει όλα τα Microsoft 365 tenants που είναι συνδεδεμένα στον πιστοποιημένο λογαριασμό.

GET /tenants/me/connections

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

Πεδία Απάντησης

Πεδίο	Τύπος	Περιγραφή
id	string	Αναγνωριστικό σύνδεσης
msTenantId	string	ID tenant Microsoft Entra (GUID)
label	string	Ετικέτα εμφάνισης που ορίστηκε κατά τη σύνδεση
connectedAt	string	Χρονοσφραγίδα ISO 8601 σύνδεσης του tenant
isPrimary	boolean	Αν αυτό είναι το τρέχον ενεργό tenant

---

Ενεργοποίηση Σύνδεσης

Ορίζει ένα συνδεδεμένο tenant ως ενεργό. Οι προβολές dashboard και τα αιτήματα API χωρίς ρητό φίλτρο tenant λειτουργούν στο ενεργό tenant.

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

Παράμετροι Μονοπατιού

Παράμετρος	Τύπος	Περιγραφή
connectionId	string	Το ID σύνδεσης προς ενεργοποίηση

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

---

Αφαίρεση Σύνδεσης

Αποσυνδέει ένα Microsoft 365 tenant. Σταματά μελλοντικές σαρώσεις για αυτό το tenant. Τα υπάρχοντα δεδομένα σαρώσεων διατηρούνται σύμφωνα με την πολιτική διατήρησης.

DELETE /tenants/me/connections/{connectionId}

WARNING

Αυτή η ενέργεια δεν μπορεί να αναιρεθεί. Η επανασύνδεση του tenant απαιτεί να περάσετε ξανά από τη ροή admin consent.

Παράμετροι Μονοπατιού

Παράμετρος	Τύπος	Περιγραφή
connectionId	string	Το ID σύνδεσης προς αφαίρεση

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

Σφάλματα

Κωδικός	HTTP	Περιγραφή
CONNECTION_NOT_FOUND	404	Δεν υπάρχει σύνδεση με αυτό το ID για αυτό το tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Δεν είναι δυνατή η αφαίρεση της μοναδικής σύνδεσης