🏠Oda Yaratma

Aşağıda, bir oda oluştururken gönderebileceğiniz parametreleri bulabilirsiniz:

Parametre	Tip	Zorunlu	Varsayılan	Açıklama
name	string	Evet	n/a	Oda adı
lang	string	Hayır	en-US	Oda oturumunun dili (bkz.)
tags	string	Hayır	null	Oda oturumunun etiketleri. Virgüller ile ayrılır.
allow_recording	bool	Hayır	true	Oda oturumunun kaydedileceği anahtarı
inaccessible_replay	bool	Hayır	false	Oda oturumunun kaydının erişime açık olmayacağı anahtarı
options	Session Options Objesi	Hayır	See object	Oda oturumunun seçenekleri (bkz.)
creator_email	string	Hayır	null	Oda oluşturacak kullanıcının email adresi

Bir oda için name parametresi özgün olmalıdır.

creator_email parametresi hakkında önemli bilgiler:

• Geçerli email formatında olmalıdır

• Eğer bu email ile bir kullanıcı mevcutsa, o kullanıcı oda yaratıcısı olarak ayarlanır

• Eğer bu email ile kullanıcı mevcut değilse, API key sahibi kullanıcı oda yaratıcısı olur

• Parametre boş bırakılırsa, API key sahibi kullanıcı oda yaratıcısı olur

Örnek istek

CURL

curl -L -X POST 'https://<DOMAIN>/xapi/v2/room' \
-H 'Content-Type: application/json' \
--data-raw '{
  "name": "Test Odası",
  "lang": "tr-TR",
  "tags": "test, api",
  "allow_recording": true,
  "inaccessible_replay": false,
  "creator_email": "[email protected]",
  "options": {
    "allow_rating": true,
    "preparation_time": 15,
    "session_duration": 60,
    "Chat": {
      "OffMessageModule": false,
      "OffGeneralMsging": false,
      "OffGeneralMsgLimitForUser": false,
      "OffSpecialMsging": false,
      "OffSpecialMsgToAdmin": false,
      "OffSpecialMsgToUser": false,
      "OffNewMsgSound": false,
      "OffClearForReplay": false,
      "OnNewMsgSoundInAll": false,
      "OnNewMsgNotifyInAll": false
    },
    "Duration": {
      "AllowExtendTime": true,
      "UseRemainingTime": false
    },
    "allow_users_stream_self_cam_mic": true,
    "hide_user_streams": false,
    "enable_attendance_check": true,
    "enable_simultaneous_interpretation": false,
    "enable_simultaneous_interpretation_for_users": false,
    "start_active": false,
    "return_url": "",
    "allow_reactions": true
  }
}'

Örnek yanıt

Oda ile ilgili diğer operasyonları gerçekleştirebilmek için ROOM_GUID parametresini saklamanız gerekir

Başarılı bir yaratma operasyonu 201 Created kodu ile aşağıdaki gövdeyi döner:

{
  "room_guid": "B5530B7F-6414-4046-87A6-67730D5F9F08",
  "name": "Test Odası",
  "lang": "tr-TR",
  "url": "https://yourdomain.com/groups/room/test-odasi_{0}",
  "created_date": "2025-08-19T12:59:00",
  "tags": "test, api",
  "inaccessible_replay": false,
  "allow_recording": true,
  "ui_options": {
    "allow_rating": true,
    "preparation_time": 15,
    "session_duration": 60,
    "chat": {
      "offMessageModule": false,
      "offGeneralMsging": false,
      "offGeneralMsgLimitForUser": false,
      "offSpecialMsging": false,
      "offSpecialMsgToAdmin": false,
      "offSpecialMsgToUser": false,
      "offNewMsgSound": false,
      "offClearForReplay": false,
      "onNewMsgSoundInAll": false,
      "onNewMsgNotifyInAll": false
    },
    "duration": {
      "allowExtendTime": true,
      "useRemainingTime": false
    },
    "allow_users_stream_self_cam_mic": true,
    "hide_user_streams": false,
    "enable_attendance_check": true,
    "enable_simultaneous_interpretation": false,
    "enable_simultaneous_interpretation_for_users": false,
    "start_active": false,
    "return_url": "",
    "allow_reactions": true
  }
}