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

نمای کلی

نقاط پایانی

ایجاد اتاق

ایجاد یک اتاق جلسه جدید. کاربر احراز هویت شده به مدیر اتاق تبدیل می‌شود.

POST /api/room/create

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

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

{
  "name": "team-standup",
  "isPublic": true,
  "mode": "standard",
  "settings": {
    "allowChat": true,
    "allowVideo": true,
    "allowAudio": true,
    "requireApproval": false,
    "e2ee": false
  }
}

توجه: فیلد name اختیاری است. اگر حذف شود یا خالی باشد، سرور یک نام تصادفی امن برای URL به صورت خودکار با فرمت xxx-xxxx-xxx (مثلاً bkf-qmzl-rja) تولید می‌کند.

قوانین نام اتاق:

نام‌های اتاق در URL به صورت https://bedrud.xyz/m/NAME نمایش داده می‌شوند، بنابراین باید امن برای URL باشند:

پاسخ (200):

{
  "id": "uuid",
  "name": "team-standup",
  "createdBy": "user-uuid",
  "isActive": true,
  "isPublic": true,
  "maxParticipants": 0,
  "settings": {
    "allowChat": true,
    "allowVideo": true,
    "allowAudio": true,
    "requireApproval": false,
    "e2ee": false
  },
  "livekitHost": "wss://lk.bedrud.xyz",
  "mode": "standard"
}

فیلدها

پیوستن به اتاق

پیوستن به یک اتاق موجود و دریافت توکن LiveKit برای اتصال رسانه.

POST /api/room/join

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

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

{
  "roomName": "team-standup"
}

پاسخ (200):

{
  "id": "uuid",
  "name": "team-standup",
  "token": "eyJ...",
  "createdBy": "user-uuid",
  "adminId": "user-uuid",
  "isActive": true,
  "isPublic": true,
  "maxParticipants": 20,
  "expiresAt": "2026-02-16T12:00:00Z",
  "settings": { ... },
  "livekitHost": "wss://lk.bedrud.xyz",
  "mode": "standard"
}

token یک توکن دسترسی امضاشده LiveKit است. برای اتصال به سرور LiveKit از طریق WebSocket از آن استفاده کنید:

import { Room } from 'livekit-client';
 
const room = new Room();
await room.connect(livekitUrl, token);

لیست اتاق‌ها

دریافت لیست اتاق‌هایی که کاربر ایجاد کرده است.

GET /api/room/list

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

پاسخ (200):

[
  {
    "id": "uuid",
    "name": "team-standup",
    "createdBy": "user-uuid",
    "isActive": true,
    "maxParticipants": 20,
    "expiresAt": "2026-02-16T12:00:00Z",
    "settings": { ... },
    "mode": "standard",
    "relationship": "creator"
  }
]

اخراج شرکت‌کننده

حذف یک شرکت‌کننده از اتاق. فقط مدیر اتاق می‌تواند این کار را انجام دهد.

POST /api/room/:roomId/kick/:identity

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

پاسخ (200):

{
  "status": "success"
}

سکوت کردن شرکت‌کننده

سکوت کردن میکروفون یک شرکت‌کننده. فقط مدیر اتاق می‌تواند این کار را انجام دهد.

POST /api/room/:roomId/mute/:identity

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

پاسخ (200):

{
  "status": "success"
}

غیرفعال کردن ویدیو شرکت‌کننده

خاموش کردن دوربین یک شرکت‌کننده. فقط مدیر اتاق می‌تواند این کار را انجام دهد.

POST /api/room/:roomId/video/:identity/off

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

پاسخ (200):

{
  "status": "success"
}

کنترل‌های مدیر

عملکردهای مدیر اتاق (اخراج، سکوت، خاموش کردن ویدیو) فقط برای کاربری در دسترس هستند که اتاق را ایجاد کرده است (adminId). تلاش برای انجام این عملکردها به عنوان غیرمدیر خطای 403 برمی‌گرداند.

ماتریس مجوزها

پاسخ‌های خطا

تمام خطاها از فرمت ثابت پیروی می‌کنند:

{
  "error": "human-readable error message"
}

خطاهای ایجاد اتاق

خطاهای عمومی

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

• نمای کلی معماری - مدل داده و جریان اتصال جلسه
• مدیریت‌کننده‌های API - نحوه پیاده‌سازی نقاط پایانی اتاق