بستری برای توسعه‌دهندگان | API سی‌روم

اگر می‌خواهید امکانات حرفه‌ای کلاس آنلاین و جلسه مجازی را مستقیماً در پلتفرم، اپلیکیشن یا سامانه اختصاصی خودتان داشته باشید، APIهای سی‌روم دقیقاً برای همین کار طراحی شده‌اند.

سی‌روم (CRoom) یک پلتفرم آموزش مجازی ایرانی است که با ارائه API، به توسعه‌دهندگان اجازه می‌دهد بدون ترک اکوسیستم خودشان، سرویس‌های کلاس آنلاین را به‌صورت کامل در محصولشان تعبیه کنند؛ از برگزاری کلاس زنده تا مدیریت دانش‌آموزان، ثبت‌نام، صدور گواهی و هر آنچه آموزش آنلاین نیاز دارد.

برای مشاهده قابلیت API Croom روی لینک بزنید تا در داخل پنل کاربری خود آن را مشاهده کنید.

چه کسانی به API سی‌روم نیاز دارند؟

  • شرکت‌های نرم‌افزاری که می‌خواهند آموزش آنلاین را به عنوان یک ماژول به محصول خود اضافه کنند

  • توسعه‌دهندگان مستقل که سامانه‌های آموزشی اختصاصی برای سازمان‌ها می‌سازند

  • استارتاپ‌های EdTech که می‌خواهند سرعت ورود به بازار را با زیرساخت آماده بالا ببرند

  • سازمان‌ها و مؤسسات که نیاز به یکپارچه‌سازی LMS داخلی با کلاس آنلاین دارند

راه‌اندازی در چند مرحله

گام اول: ایجاد توکن API

توکن API کلید دسترسی شما به تمام سرویس‌های سی‌روم است. برای ایجاد آن:

  1. وارد داشبورد کاربری خود در سی‌روم شوید.

  2. از منوی سمت راست، گزینه توکن‌های API را انتخاب کنید.

  3. روی دکمه ایجاد توکن جدید کلیک کنید.

  4. یک نام توصیفی برای توکن انتخاب کنید (مثلاً: «سامانه آموزشی شرکت X» یا «اپلیکیشن موبایل») تا در آینده به‌راحتی قابل شناسایی باشد.

  5. در صورت نیاز، تاریخ انقضا تعیین کنید. این گزینه برای پروژه‌های با دسترسی محدود بسیار توصیه می‌شود.

  6. پس از ایجاد، توکن را کپی و در جای امنی ذخیره کنید. این توکن دیگر نمایش داده نخواهد شد.

⚠️ نکته امنیتی مهم: توکن API معادل رمز عبور حساب شماست. هرگز آن را در کدهای عمومی (مثل GitHub)، ایمیل یا پیام‌رسان‌ها به اشتراک نگذارید. اگر به هر دلیلی مشکوک به افشای توکن شدید، فوراً آن را غیرفعال کرده و توکن جدید بسازید.


مراحل راه اندازی توکل api در سی‌روم

گام دوم: مطالعه مستندات

راهنمای کامل APIهای سی‌روم شامل موارد زیر است:

  • ✅ نحوه احراز هویت (Authentication) با توکن

  • ✅ لیست کامل Endpointها و پارامترهای هر درخواست

  • ✅ نمونه‌های واقعی Request و Response برای هر سرویس

  • ✅ کدهای خطا و راهنمای رفع اشکال

  • ✅ محدودیت‌های نرخ درخواست (Rate Limit)

📖 مشاهده مستندات کامل API سی‌روم

لیست مستندات کامل API سی‌روم - 1


لیست مستندات کامل API سی‌روم - 2

دسترسی به API بسته به نوع اشتراک متفاوت است. برای اطلاع از اینکه پلن شما شامل دسترسی API می‌شود یا خیر، با پشتیبانی سی‌روم تماس بگیرید یا داشبورد خود را بررسی کنید.
بله. توصیه می‌شود برای هر پروژه یا محصول جداگانه یک توکن مستقل بسازید. این کار مدیریت دسترسی‌ها را آسان‌تر می‌کند و در صورت افشای یک توکن، بقیه پروژه‌ها تحت تأثیر قرار نمی‌گیرند.
به دلایل امنیتی، توکن پس از ساخت اولیه دیگر نمایش داده نمی‌شود. در صورت گم شدن، باید توکن قدیمی را غیرفعال و یک توکن جدید بسازید.
بله، مانند اکثر APIهای حرفه‌ای، محدودیت نرخ درخواست (Rate Limit) وجود دارد. جزئیات کامل آن در صفحه مستندات سی‌روم شرح داده شده است.
بله، APIهای سی‌روم بر پایه پروتکل HTTP/REST هستند و با هر زبان برنامه‌نویسی و پلتفرمی (Android، iOS، وب، سرور) قابل استفاده‌اند.
مستندات فنی در آدرس https://api.croom.ir/docs موجود است. برای سؤالات تخصصی‌تر می‌توانید از طریق کانال پشتیبانی سی‌روم با تیم فنی در ارتباط باشید.