واجهة كوسكول البرمجية للشركاء
لمنصات التعلّم التي تريد أن تقدّم لطلابها دورات كوسكول المرئية وفق المنهج السعودي، داخل منتجها نفسه.
مثال
POST https://www.cosqool.com/api-sandbox/api/partner/v1/enrollments/
Authorization: Api-Key <your sandbox key>
{ "course_id": 17,
"transaction_id": "order-1001",
"external_student_id": "student-42",
"duration": "monthly" }
201 Created
{ "id": 1, "status": "active", "expires_at": "2026-11-01T09:00:00Z" }طلب على بيئة الاختبار، مختصَر. المعرّفات أمثلة للتوضيح.
ما الذي تغطيه
- الفهرس: ابحث عن الدورات حسب الصف والفصل الدراسي، واقرأ كل دورة بأقسامها ودروسها وعناصرها.
- التسجيل: سجّل أحد طلابك في دورة لمدة شهر أو ستة أشهر أو سنة، وألغِ التسجيل عند الحاجة.
- العرض: اطلب عنوان فيديو الدرس لطالب مسجَّل وشغّله في مشغّلك.
- التقدّم: سجّل ما أكمله الطالب واقرأ تقدّمه في الدورة.
- الإشعارات: بعد تسجيل عنوان الاستقبال لديك، تُبلّغ كوسكول خادمك بتحديثات الدورات والتقدّم والإكمال والإلغاء.
لمن هي
المنصات التعليمية وأنظمة إدارة التعلّم وشبكات المدارس التي لديها طلابها ونظام دخولها.
ما الذي تحتاجه
مفتاح للواجهة تصدره كوسكول. يبدأ كل شريك في بيئة الاختبار، وهي بيئة منفصلة لها مفتاحها. يُصدَر مفتاح الإنتاج عند الإطلاق، وتُحدَّد الشروط التجارية مع كل شريك.
كيف تعمل
- تواصل معنا وعرّفنا بمنصتك.
- استلم مفتاح بيئة الاختبار واتصل ببيئة الاختبار (API Sandbox)، وفيها المرجع الكامل.
- ابنِ تكاملك على بيئة الاختبار: ابحث، وسجّل طلاباً تجريبيين، وشغّل الدروس، وسجّل التقدّم.
- اتفق معنا على موعد الإطلاق واستلم مفتاح الإنتاج.
يحسن أن تعرف
- الدروس فيديوهات تُشرح بالعربية وفق المنهج السعودي: الصفوف من الأول إلى الثاني عشر، الفصلان الدراسيان الأول والثاني، مع التحضير للقدرات والتحصيلي.
- تعرّف كل طالب بمعرّف من عندك. لا تطلب كوسكول كلمات مرور طلابك أبداً.
- يعمل المفتاح في بيئة واحدة فقط وله حد لعدد الطلبات. ومفتاح بيئة الاختبار يُرفض في بيئة الإنتاج.
- يشمل العرض دروس الدورة وملفاتها. أما أدوات الدراسة بالذكاء الاصطناعي في لوحة كوسكول فليست جزءاً منه.
- عند انتهاء المدة أو إلغاء التسجيل تُرفض طلبات الفيديو الجديدة لذلك الطالب.
أسئلة شائعة
- كيف نحصل على صلاحية الاستخدام؟
- راسلنا عبر صفحة «تواصل معنا» أو على info@cosqool.com وعرّفنا بمنصتك. نصدر أولاً مفتاح بيئة الاختبار.
- هل توجد بيئة للاختبار؟
- نعم. لبيئة الاختبار مفتاحها وبياناتها ومرجع تفاعلي. وما يُنفَّذ فيها لا يمسّ طلاباً حقيقيين.
- كم التكلفة؟
- تُحدَّد الشروط التجارية مع كل شريك، ولا توجد قائمة أسعار عامة للواجهة.
- بأي لغة كُتب المرجع؟
- بالإنجليزية.
- هل ترسلون أحداثاً إلى خادمنا؟
- نعم، بعد تسجيل عنوان الاستقبال وبيانات الاعتماد لديكم. وإلى ذلك الحين تُرجع الواجهة نفسها البيانات الحالية دائماً.