API Connections

Maintenu par : Aether365 Team Public : Développeurs Périmètre : Endpoints de l'API Connections - gestion des connexions de tenants Microsoft 365

Les connexions représentent les tenants Microsoft 365 liés. Chaque connexion correspond à un tenant Microsoft (identifié par son msTenantId) ayant reçu le consentement administrateur.

Lister les connexions

Renvoie tous les tenants Microsoft 365 connectés au compte authentifié.

GET /tenants/me/connections

Exemple de requête

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

Exemple de réponse

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

Champs de la réponse

Champ	Type	Description
id	string	Identifiant de la connexion
msTenantId	string	Identifiant du tenant Microsoft Entra (GUID)
label	string	Libellé d'affichage attribué lors de la connexion
connectedAt	string	Horodatage ISO 8601 de la connexion du tenant
isPrimary	boolean	Indique s'il s'agit du tenant actuellement actif

---

Activer une connexion

Définit un tenant connecté comme tenant actif. Les vues du tableau de bord et les appels API sans filtre de tenant explicite s'appliquent au tenant actif.

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

Paramètres de chemin

Paramètre	Type	Description
connectionId	string	Identifiant de la connexion à activer

Exemple de requête

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

Exemple de réponse

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

---

Supprimer une connexion

Déconnecte un tenant Microsoft 365. Arrête les analyses futures pour ce tenant. Les données d'analyse existantes sont conservées conformément à la politique de rétention.

DELETE /tenants/me/connections/{connectionId}

WARNING

Cette action est irréversible. Reconnecter le tenant nécessite de repasser par le flux de consentement administrateur.

Paramètres de chemin

Paramètre	Type	Description
connectionId	string	Identifiant de la connexion à supprimer

Exemple de requête

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

Exemple de réponse

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

Erreurs

Code	HTTP	Description
CONNECTION_NOT_FOUND	404	Aucune connexion avec cet identifiant n'existe pour ce tenant
CANNOT_REMOVE_LAST_CONNECTION	409	Impossible de supprimer la dernière connexion restante