> For the complete documentation index, see [llms.txt](https://developer.perculus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.perculus.com/v2-tr/servisler/oda-yonetimi/oda-yaratma.md).

# Oda Yaratma

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

<table data-full-width="false"><thead><tr><th width="155">Parametre</th><th width="126">Tip</th><th width="128">Zorunlu</th><th width="122.8887939453125">Varsayılan</th><th>Açıklama</th></tr></thead><tbody><tr><td>name</td><td>string</td><td>Evet</td><td>n/a</td><td>Oda adı</td></tr><tr><td>lang</td><td>string</td><td>Hayır</td><td>en-US</td><td>Oda oturumunun dili (<a href="/pages/jn8hFrbjV7ogmd6AhqFG">bkz.</a>)</td></tr><tr><td>tags</td><td>string</td><td>Hayır</td><td>null</td><td>Oda oturumunun etiketleri. Virgüller ile ayrılır</td></tr><tr><td>inaccessible_replay</td><td>bool</td><td>Hayır</td><td>false</td><td>Oda oturumunun kaydının erişime açık olmayacağı anahtarı</td></tr><tr><td>options</td><td><a href="/pages/n3tFLWHm00VpqyNG8x3u">Session Options Objesi</a></td><td>Hayır</td><td><em>See object</em></td><td>Oda oturumunun seçenekleri  (<a href="/pages/n3tFLWHm00VpqyNG8x3u">bkz.</a>)</td></tr><tr><td>creator_email</td><td>string</td><td>Hayır</td><td>null</td><td>Oda oluşturacak kullanıcının email adresi</td></tr><tr><td>room_hosts</td><td>string[]</td><td>Hayır</td><td>null</td><td>Oda eğitmenleri olarak atanacak kullanıcı GUID listesi</td></tr></tbody></table>

{% hint style="warning" %}
Bir oda için **name** parametresi özgün olmalıdır

&#x20;**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
* Odayı yaratan kullanıcı her durumda otomatik eğitmen olarak eklenir
  {% endhint %}

**Örnek istek**

{% tabs %}
{% tab title="CURL" %}

```bash
curl -L -X POST 'https://<DOMAIN>/api/groups/xapi/room' \
-H 'Content-Type: application/json' \
--data-raw '{
  "name": "Test Odası",
  "lang": "tr-TR",
  "tags": "test, api",
  "inaccessible_replay": false,
  "creator_email": "test@example.com",
  "room_hosts": ["<user_guid_1>", "<user_guid_2>"]
  "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
  }
}'
```

{% endtab %}
{% endtabs %}

**Örnek yanıt**

{% hint style="info" %}
Oda ile ilgili diğer operasyonları gerçekleştirebilmek için `ROOM_GUID` parametresini saklamanız gerekir
{% endhint %}

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

```json
{
  "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,
  "room_hosts": ["A1B2C3D4-E5F6-7890-ABCD-EF1234567890"],
  "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
  }
}

```