Bağlantılar API

Hazırlayan: Aether365 Ekibi Hedef Kitle: Geliştiriciler Kapsam: Bağlantı API endpoint'leri - Microsoft 365 tenant bağlantılarını yönetme

Bağlantılar, bağlı Microsoft 365 tenant'larını temsil eder. Her bağlantı, yönetici onayı verilmiş bir Microsoft tenant'ına (msTenantId ile tanımlanan) karşılık gelir.

Bağlantıları Listeleme

Kimlik doğrulanmış hesaba bağlı tüm Microsoft 365 tenant'larını döndürür.

GET /tenants/me/connections

Örnek İstek

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

Örnek Yanıt

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

Yanıt Alanları

Alan	Tür	Açıklama
id	string	Bağlantı tanımlayıcısı
msTenantId	string	Microsoft Entra tenant kimliği (GUID)
label	string	Bağlantı sırasında atanan görünen etiket
connectedAt	string	Tenant'ın bağlandığı ISO 8601 zaman damgası
isPrimary	boolean	Şu anda aktif tenant olup olmadığı

---

Bağlantıyı Etkinleştirme

Bağlı bir tenant'ı aktif tenant olarak ayarlar. Açık tenant filtresi olmayan dashboard görünümleri ve API çağrıları aktif tenant üzerinde çalışır.

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

Yol Parametreleri

Parametre	Tür	Açıklama
connectionId	string	Etkinleştirilecek bağlantı kimliği

Örnek İstek

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

Örnek Yanıt

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

---

Bağlantıyı Kaldırma

Bir Microsoft 365 tenant'ının bağlantısını keser. Bu tenant için gelecekteki taramaları durdurur. Mevcut tarama verileri saklama politikasına göre korunur.

DELETE /tenants/me/connections/{connectionId}

WARNING

Bu işlem geri alınamaz. Tenant'ı yeniden bağlamak, yönetici onay akışını tekrar geçmeyi gerektirir.

Yol Parametreleri

Parametre	Tür	Açıklama
connectionId	string	Kaldırılacak bağlantı kimliği

Örnek İstek

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

Örnek Yanıt

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

Hatalar

Kod	HTTP	Açıklama
CONNECTION_NOT_FOUND	404	Bu tenant için bu kimliğe sahip bağlantı mevcut değil
CANNOT_REMOVE_LAST_CONNECTION	409	Kalan tek bağlantı kaldırılamaz