نقاط نهاية إدارة الغرف تحت /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 اختياري. إذا تم حذفه أو تركه فارغًا، سيُنشئ الخادم اسمًا عشوائيًا آمنًا للروابط بتنسيق xxx-xxxx-xxx (مثل bkf-qmzl-rja).

قواعد اسم الغرفة:

تظهر أسماء الغرف في الرابط كـ https://bedrud.xyz/m/NAME، لذا يجب أن تكون آمنة للروابط:

الاستجابة (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 - كيفية تنفيذ نقاط نهاية الغرف