Ekip Üyeleri API

Hazırlayan: Aether365 Ekibi Hedef Kitle: Geliştiriciler Kapsam: Ekip üyesi API endpoint'leri - kullanıcı erişimini yönetme

Yetkilendirme

Ekip üyesi endpoint'leri rol tabanlı erişim kontrolü kullanır:

Endpoint	İzin verilen roller
Üyeleri listele	Owner, Admin, Member
Üye davet et	Owner, Admin
Üye rolünü değiştir	Owner
Üye kaldır	Owner

---

Ekip Üyelerini Listeleme

Kimlik doğrulanmış tenant hesabının tüm üyelerini döndürür.

GET /tenants/me/members

Örnek İstek

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

Örnek Yanıt

{
  "success": true,
  "data": [
    {
      "id": "mem_abc123",
      "email": "alice@example.com",
      "status": "active",
      "role": "owner",
      "invitedAt": "2026-01-15T10:00:00Z",
      "joinedAt": "2026-01-15T10:30:00Z"
    },
    {
      "id": "mem_def456",
      "email": "bob@example.com",
      "status": "active",
      "role": "member",
      "invitedAt": "2026-02-01T09:00:00Z",
      "joinedAt": "2026-02-01T11:00:00Z"
    },
    {
      "id": "mem_ghi789",
      "email": "carol@example.com",
      "status": "pending",
      "role": "member",
      "invitedAt": "2026-04-10T08:00:00Z",
      "joinedAt": null
    }
  ]
}

Yanıt Alanları

Alan	Tür	Açıklama
id	string	Üye tanımlayıcısı
email	string	Üye e-posta adresi
status	string	active veya pending
role	string	owner, admin veya member
invitedAt	string	Davet ISO 8601 zaman damgası
joinedAt	string veya null	Davetin kabul edildiği ISO 8601 zaman damgası

---

Ekip Üyesi Davet Etme

Yeni bir ekip üyesine davet e-postası gönderir.

POST /tenants/me/members/invite

İstek Gövdesi

{
  "email": "newmember@example.com",
  "role": "member"
}

Alan	Tür	Gerekli	Varsayılan	Açıklama
email	string	Evet	-	Davet edilecek e-posta adresi
role	string	Hayır	"member"	"member" veya "admin"

Örnek İstek

curl -X POST https://api.aether365.io/tenants/me/members/invite \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"email": "newmember@example.com", "role": "member"}'

Örnek Yanıt

{
  "success": true,
  "data": {
    "id": "mem_xyz999",
    "email": "newmember@example.com",
    "status": "pending",
    "role": "member",
    "invitedAt": "2026-04-12T10:00:00Z",
    "joinedAt": null
  }
}

Hatalar

Kod	HTTP	Açıklama
MEMBER_LIMIT_REACHED	429	Plan üye limiti aşıldı
MEMBER_ALREADY_EXISTS	409	Bu e-posta zaten bir üye veya bekleyen bir davete sahip
VALIDATION_ERROR	400	Geçersiz e-posta adresi

---

Ekip Üyesinin Rolünü Değiştirme

Mevcut bir ekip üyesinin rolünü değiştirir.

PATCH /tenants/me/members/{memberId}

WARNING

Yalnızca hesap sahibi (Owner) rolleri değiştirebilir. Admin kullanıcılar rol değişikliği yapamaz.

İstek Gövdesi

{
  "role": "admin"
}

Alan	Tür	Gerekli	Açıklama
role	string	Evet	Yeni rol: "member" veya "admin"

Örnek İstek

curl -X PATCH https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

Örnek Yanıt

{
  "success": true,
  "data": {
    "id": "mem_def456",
    "email": "bob@example.com",
    "status": "active",
    "role": "admin",
    "invitedAt": "2026-02-01T09:00:00Z",
    "joinedAt": "2026-02-01T11:00:00Z"
  }
}

---

Ekip Üyesini Kaldırma

Bir üyeyi hesaptan kaldırır. Erişimi hemen sona erer.

DELETE /tenants/me/members/{memberId}

WARNING

Hesap sahibini kaldırmak mümkün değildir. Sahipliği devretmek için destek ekibiyle iletişime geçin.

Örnek İstek

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

Örnek Yanıt

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