اتاق آنلاین،
داخل محصول خودتان

curl -X GET "https://api.connectu.ir/v1/account" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": {
    "id": "cm3x9jorg0001",
    "name": "سازمان نمونه",
    "link_name": "school",
    "rooms": 12,
    "users": 840,
    "online_now": 57,
    "recording_seconds_left": 64800,
    "subscriptions": [
      {
        "id": "cm3x9k0subs00001",
        "plan": "۱۰۰ کاربر",
        "kind": "educational",
        "seats": 100,
        "video_limit": 4,
        "storage_mb": 500,
        "starts_at": "2026-09-01T00:00:00.000Z",
        "ends_at": "2027-03-01T00:00:00.000Z",
        "active": true
      }
    ],
    "addons": [
      {
        "kind": "api",
        "ends_at": "2027-10-29T00:00:00.000Z"
      }
    ]
  }
}

curl -X GET "https://api.connectu.ir/v1/rooms" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": [
    {
      "id": "cm3x9k2rooma1b2c3",
      "title": "ریاضی پایه‌ی دهم",
      "slug": "math-10",
      "status": "active",
      "login_mode": "username_password",
      "allow_guests": false,
      "guest_role": "user",
      "max_users": 40,
      "max_guests": null,
      "subscription_id": "cm3x9k0subs00001",
      "join_url": "https://school.connectu.ir/math-10",
      "total_minutes": 1260,
      "created_at": "2026-10-01T08:30:00.000Z",
      "updated_at": "2026-10-20T11:02:41.000Z"
    }
  ],
  "next_cursor": null
}

curl -X POST "https://api.connectu.ir/v1/rooms" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"ریاضی پایه‌ی دهم","slug":"math-10","subscription_id":"cm3x9k0subs00001","max_users":40}'

{
  "data": {
    "id": "cm3x9k2rooma1b2c3",
    "title": "ریاضی پایه‌ی دهم",
    "slug": "math-10",
    "status": "active",
    "login_mode": "username_password",
    "allow_guests": false,
    "guest_role": "user",
    "max_users": 40,
    "max_guests": null,
    "subscription_id": "cm3x9k0subs00001",
    "join_url": "https://school.connectu.ir/math-10",
    "total_minutes": 1260,
    "created_at": "2026-10-01T08:30:00.000Z",
    "updated_at": "2026-10-20T11:02:41.000Z"
  }
}

curl -X GET "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": {
    "id": "cm3x9k2rooma1b2c3",
    "title": "ریاضی پایه‌ی دهم",
    "slug": "math-10",
    "status": "active",
    "login_mode": "username_password",
    "allow_guests": false,
    "guest_role": "user",
    "max_users": 40,
    "max_guests": null,
    "subscription_id": "cm3x9k0subs00001",
    "join_url": "https://school.connectu.ir/math-10",
    "total_minutes": 1260,
    "created_at": "2026-10-01T08:30:00.000Z",
    "updated_at": "2026-10-20T11:02:41.000Z"
  }
}

curl -X PATCH "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"inactive"}'

{
  "data": {
    "id": "cm3x9k2rooma1b2c3",
    "title": "ریاضی پایه‌ی دهم",
    "slug": "math-10",
    "status": "inactive",
    "login_mode": "username_password",
    "allow_guests": false,
    "guest_role": "user",
    "max_users": 40,
    "max_guests": null,
    "subscription_id": "cm3x9k0subs00001",
    "join_url": "https://school.connectu.ir/math-10",
    "total_minutes": 1260,
    "created_at": "2026-10-01T08:30:00.000Z",
    "updated_at": "2026-10-20T11:02:41.000Z"
  }
}

curl -X DELETE "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

curl -X GET "https://api.connectu.ir/v1/users" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": [
    {
      "id": "cm3x9k7usere4f5g6",
      "full_name": "سارا احمدی",
      "username": "0012345678",
      "phone": "09121234567",
      "created_at": "2026-10-02T09:15:00.000Z"
    }
  ],
  "next_cursor": "cm3x9k7usere4f5g6"
}

curl -X POST "https://api.connectu.ir/v1/users" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"سارا احمدی","username":"0012345678","phone":"09121234567"}'

{
  "data": {
    "id": "cm3x9k7usere4f5g6",
    "full_name": "سارا احمدی",
    "username": "0012345678",
    "phone": "09121234567",
    "created_at": "2026-10-02T09:15:00.000Z",
    "generated_password": "k7m2p9qa"
  }
}

curl -X GET "https://api.connectu.ir/v1/users/cm3x9k7usere4f5g6" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": {
    "id": "cm3x9k7usere4f5g6",
    "full_name": "سارا احمدی",
    "username": "0012345678",
    "phone": "09121234567",
    "created_at": "2026-10-02T09:15:00.000Z",
    "rooms": [
      {
        "room_id": "cm3x9k2rooma1b2c3",
        "role": "user"
      }
    ]
  }
}

curl -X PATCH "https://api.connectu.ir/v1/users/cm3x9k7usere4f5g6" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"password":"new-pass-2026"}'

{
  "data": {
    "id": "cm3x9k7usere4f5g6",
    "full_name": "سارا احمدی",
    "username": "0012345678",
    "phone": "09121234567",
    "created_at": "2026-10-02T09:15:00.000Z"
  }
}

curl -X DELETE "https://api.connectu.ir/v1/users/cm3x9k7usere4f5g6" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

curl -X GET "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/members" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": [
    {
      "id": "cm3x9k7usere4f5g6",
      "full_name": "سارا احمدی",
      "username": "0012345678",
      "phone": "09121234567",
      "created_at": "2026-10-02T09:15:00.000Z",
      "role": "user"
    }
  ],
  "next_cursor": null
}

curl -X PUT "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/members/cm3x9k7usere4f5g6" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role":"operator"}'

{
  "data": {
    "id": "cm3x9k7usere4f5g6",
    "full_name": "سارا احمدی",
    "username": "0012345678",
    "phone": "09121234567",
    "created_at": "2026-10-02T09:15:00.000Z",
    "role": "operator"
  }
}

curl -X DELETE "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/members/cm3x9k7usere4f5g6" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

curl -X POST "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/login-links" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"cm3x9k7usere4f5g6","expires_in":120}'

{
  "data": {
    "url": "https://school.connectu.ir/math-10?ticket=Qm9sZC1hbmQtc2VjdXJlLXRpY2tldA",
    "expires_at": "2026-10-29T10:02:00.000Z",
    "single_use": true
  }
}

curl -X GET "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/online" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": [
    {
      "identity": "member-cm3x9k7usere4f5g6",
      "type": "user",
      "user_id": "cm3x9k7usere4f5g6",
      "name": "سارا احمدی",
      "joined_at": "2026-10-29T09:30:12.000Z",
      "attendance_id": "cm3x9kjoin0001",
      "online_minutes": 34
    }
  ]
}

curl -X DELETE "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/online/member-cm3x9k7usere4f5g6" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ban_minutes":10}'

curl -X GET "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/attendance" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": [
    {
      "id": "cm3x9kjoin0001",
      "identity": "member-cm3x9k7usere4f5g6",
      "type": "user",
      "user_id": "cm3x9k7usere4f5g6",
      "name": "سارا احمدی",
      "joined_at": "2026-10-28T09:30:12.000Z",
      "left_at": "2026-10-28T10:58:40.000Z",
      "minutes": 88
    }
  ],
  "next_cursor": null
}

curl -X GET "https://api.connectu.ir/v1/rooms/cm3x9k2rooma1b2c3/recordings" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": [
    {
      "id": "cm3x9kerech7i8j9",
      "room_id": "cm3x9k2rooma1b2c3",
      "status": "done",
      "started_by": "علی رضایی",
      "stopped_by": "علی رضایی",
      "started_at": "2026-10-28T09:31:00.000Z",
      "ended_at": "2026-10-28T10:55:10.000Z",
      "duration_seconds": 5050,
      "size_bytes": 412334080,
      "download_url": "https://connectu.ir/api/v1/recordings/cm3x9kerech7i8j9/download?s=…",
      "download_expires_at": "2026-10-29T11:00:00.000Z"
    }
  ],
  "next_cursor": null
}

curl -X GET "https://api.connectu.ir/v1/recordings/cm3x9kerech7i8j9" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": {
    "id": "cm3x9kerech7i8j9",
    "room_id": "cm3x9k2rooma1b2c3",
    "status": "done",
    "duration_seconds": 5050,
    "download_url": "https://connectu.ir/api/v1/recordings/…/download?s=…"
  }
}

curl -X DELETE "https://api.connectu.ir/v1/recordings/cm3x9kerech7i8j9" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

curl -X GET "https://api.connectu.ir/v1/webhook" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": {
    "url": "https://school.ir/hooks/connectu",
    "secret": "whsec_8Kq2…"
  }
}

curl -X PUT "https://api.connectu.ir/v1/webhook" \
  -H "Authorization: Bearer $CONNECTU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://school.ir/hooks/connectu"}'

{
  "data": {
    "url": "https://school.ir/hooks/connectu",
    "secret": "whsec_8Kq2…"
  }
}

curl -X POST "https://api.connectu.ir/v1/webhook/test" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"

{
  "data": {
    "delivered": true,
    "status": 200
  }
}

curl -X DELETE "https://api.connectu.ir/v1/webhook" \
  -H "Authorization: Bearer $CONNECTU_TOKEN"