Oda yönetimi uç noktaları /api/room/ altındadır. Tüm uç noktalar kimlik doğrulaması gerektirir.

Genel Bakış

Uç Noktalar

Oda Oluştur

Yeni bir toplantı odası oluşturun. Kimliği doğrulanmış kullanıcı oda yöneticisi olur.

POST /api/room/create

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

İstek Gövdesi:

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

Not: name alanı isteğe bağlıdır. Atlanır veya boş bırakılırsa, sunucu xxx-xxxx-xxx formatında rastgele bir URL uyumlu isim otomatik olarak oluşturur (ör. bkf-qmzl-rja).

Oda İsim Kuralları:

Oda isimleri URL’de https://bedrud.xyz/m/NAME şeklinde görünür, bu nedenle URL uyumlu olmalıdır:

Yanıt (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"
}

Alanlar

Odaya Katıl

Var olan bir odaya katılın ve medya bağlantısı için bir LiveKit token alın.

POST /api/room/join

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

İstek Gövdesi:

{
  "roomName": "team-standup"
}

Yanıt (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, imzalı bir LiveKit erişim token’ıdır. WebSocket üzerinden LiveKit sunucusuna bağlanmak için kullanın:

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

Odaları Listele

Kullanıcının oluşturduğu odaların listesini alın.

GET /api/room/list

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

Yanıt (200):

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

Katılımcıyı At

Bir katılımcıyı odadan çıkarın. Bunu yalnızca oda yöneticisi yapabilir.

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

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

Yanıt (200):

{
  "status": "success"
}

Katılımcıyı Sessize Al

Bir katılımcının mikrofonunu sessize alın. Bunu yalnızca oda yöneticisi yapabilir.

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

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

Yanıt (200):

{
  "status": "success"
}

Katılımcı Videosunu Kapat

Bir katılımcının kamerasını kapatın. Bunu yalnızca oda yöneticisi yapabilir.

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

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

Yanıt (200):

{
  "status": "success"
}

Yönetici Kontrolleri

Oda yöneticisi eylemleri (atma, sessize alma, video kapatma) yalnızca odayı oluşturan kullanıcıya (adminId) açıktır. Yönetici olmayan bir kullanıcı bu eylemleri denediğinde 403 hatası döner.

İzinler Matrisi

Hata Yanıtları

Tüm hatalar tutarlı bir format izler:

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

Oda Oluşturma Hataları

Genel Hatalar

Ayrıca bakınız

• Mimari Genel Bakış - veri modeli ve toplantı bağlantı akışı
• API İşleyicileri - oda uç noktalarının nasıl uygulandığı