Bedrud Belgeler

Yönetici uç noktaları /api/admin/ altındadır. Bu uç noktalar Süper Yönetici rolü gerektirir.

Genel Bakış

Uç NoktaYöntemAçıklama
/api/admin/usersGETTüm kullanıcıları listele
/api/admin/users/:id/statusPUTBir kullanıcıyı aktifleştir veya devre dışı bırak

Uç Noktalar

Tüm Kullanıcıları Listele

Kayıtlı tüm kullanıcıların listesini alın.

GET /api/admin/users

Başlıklar: Authorization: Bearer <accessToken>

Gerekli Rol: Süper Yönetici

Yanıt (200):

{
  "users": [
    {
      "id": "uuid",
      "email": "user@example.com",
      "name": "John Doe",
      "avatar": "https://...",
      "role": "user",
      "provider": "email",
      "isActive": true,
      "createdAt": "2025-01-15T10:30:00Z"
    },
    {
      "id": "uuid-2",
      "email": "admin@example.com",
      "name": "Admin User",
      "role": "admin",
      "provider": "email",
      "isActive": true,
      "createdAt": "2025-01-10T08:00:00Z"
    }
  ]
}

Kullanıcı Durumunu Güncelle

Bir kullanıcı hesabını aktifleştirin veya devre dışı bırakın. Devre dışı bırakılan kullanıcılar giriş yapamaz.

PUT /api/admin/users/:id/status

Başlıklar: Authorization: Bearer <accessToken>

Gerekli Rol: Süper Yönetici

URL Parametreleri:

ParametreAçıklama
idKullanıcı UUID’si

İstek Gövdesi:

{
  "isActive": false
}

Yanıt (200):

{
  "message": "user status updated",
  "user": {
    "id": "uuid",
    "email": "user@example.com",
    "isActive": false
  }
}

Kullanıcı Rolleri

RolAçıklamaİzinler
guestGeçici kullanıcıYalnızca odalara katılma
userNormal kullanıcıOda oluşturma/katılma, kendi profilini yönetme
adminSüper YöneticiTüm kullanıcı izinleri + kullanıcıları yönetme, tüm odaları görme

Yönetici Oluşturma

Yönetici kullanıcılar CLI üzerinden oluşturulur:

# Bir kullanıcı oluştur
bedrud user create --email "admin@example.com" --password "securepassword" --name "Admin"
 
# Yöneticiye yükselt
bedrud user promote --email "admin@example.com"

Kullanıcıları yükseltmek için bir API uç noktası yoktur - bu, güvenlik amacıyla bilinçli olarak tasarlanmıştır.


Hata Yanıtları

{
  "error": "forbidden"
}
DurumAnlamı
401Kimlik doğrulaması yapılmamış
403Süper Yönetici değil
404Kullanıcı bulunamadı
500İç sunucu hatası

Ayrıca bakınız