Bedrud مستندات

نقاط پایانی مدیر تحت /api/admin/ هستند. این‌ها نیاز به نقش مدیر ارشد دارند.

نمای کلی

نقطه پایانیروشتوضیحات
/api/admin/usersGETلیست همه کاربران
/api/admin/users/:id/statusPUTفعال یا غیرفعال کردن یک کاربر

نقاط پایانی

لیست همه کاربران

دریافت لیست همه کاربران ثبت‌نام شده.

GET /api/admin/users

هدرها: Authorization: Bearer <accessToken>

نقش مورد نیاز: مدیر ارشد

پاسخ (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"
    }
  ]
}

به‌روزرسانی وضعیت کاربر

فعال یا غیرفعال کردن یک حساب کاربری. کاربران غیرفعال نمی‌توانند وارد شوند.

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

هدرها: Authorization: Bearer <accessToken>

نقش مورد نیاز: مدیر ارشد

پارامترهای URL:

پارامترتوضیحات
idUUID کاربر

بدنه درخواست:

{
  "isActive": false
}

پاسخ (200):

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

نقش‌های کاربر

نقشتوضیحاتمجوزها
guestکاربر موقتفقط پیوستن به اتاق‌ها
userکاربر عادیایجاد/پیوستن به اتاق‌ها، مدیریت پروفایل خود
adminمدیر ارشدتمام مجوزهای کاربر + مدیریت کاربران، مشاهده همه اتاق‌ها

ایجاد یک مدیر

کاربران مدیر از طریق CLI ایجاد می‌شوند:

# ایجاد یک کاربر
bedrud user create --email "admin@example.com" --password "securepassword" --name "Admin"
 
# ارتقا به مدیر
bedrud user promote --email "admin@example.com"

هیچ نقطه پایانی API برای ارتقای کاربران وجود ندارد - این امر عمدی برای امنیت است.


پاسخ‌های خطا

{
  "error": "forbidden"
}
وضعیتمعنی
401احراز هویت نشده
403مدیر ارشد نیست
404کاربر یافت نشد
500خطای داخلی سرور

مشاهده همچنین