نقاط پایانی مدیر تحت /api/admin/ هستند. اینها نیاز به نقش مدیر ارشد دارند.
نمای کلی
| نقطه پایانی | روش | توضیحات |
|---|---|---|
/api/admin/users | GET | لیست همه کاربران |
/api/admin/users/:id/status | PUT | فعال یا غیرفعال کردن یک کاربر |
نقاط پایانی
لیست همه کاربران
دریافت لیست همه کاربران ثبتنام شده.
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:
| پارامتر | توضیحات |
|---|---|
id | UUID کاربر |
بدنه درخواست:
{
"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 | خطای داخلی سرور |
مشاهده همچنین
- مدیریتکنندههای API و مسیریابی - نحوه پیادهسازی مسیرهای مدیر
- API اتاقها - نقاط پایانی مدیریت اتاق