تعتمد المدارس بشكل متزايد على أنظمة متعددة لإدارة الطلاب والموظفين والأنشطة، وكان الحفاظ على تزامن هذه البيانات يتطلب تاريخيًا إعادة إدخالها يدويًا أو حلولًا بديلة مخصصة. تُغيّر واجهة برمجة التطبيقات العامة SchoolsBuddy هذا الواقع، إذ تُتيح للمدارس طريقة آمنة ومباشرة لربط SchoolsBuddy بالأدوات التي تستخدمها بالفعل.

تم تصميم واجهة برمجة التطبيقات (API) حول إدارة المستخدمين والأنشطة الأساسية، مما يمنح فرق التطوير طريقة قابلة للتطوير ومرنة للتفاعل مع SchoolsBuddy برمجيًا، مع تحكم صارم في الوصول من قبل المشرفين الرئيسيين للمؤسسة للحفاظ على أمان كل عملية تكامل.

ملخص

صُممت واجهة برمجة التطبيقات العامة SchoolsBuddy لتقليل إدخال البيانات يدويًا والحفاظ على مزامنة البيانات عبر منظومة مدرستك. وهي مصممة خصيصًا للفرق التقنية، وخاصةً مديري الأنظمة الرئيسيين ومطوري البرامج، الذين يحتاجون إلى أتمتة المهام الإدارية الجماعية أو دمج SchoolsBuddy مع منصة إدارة معلومات الطلاب (MIS/SIS) مخصصة أو مطورة داخليًا.

ما الجديد

تتضمن واجهة برمجة التطبيقات (API) نقاط نهاية لكيانات البيانات الأساسية، بما في ذلك الطلاب، وجهات الاتصال، والموظفين، والفعاليات، والمواقع، والمجموعات، وتفضيلات التسجيل الفوري للكتب. وتشمل القدرات الرئيسية ما يلي:

• إدارة المواقع: إنشاء وإدارة مواقع مخصصة لاستخدامها في جميع أنشطة المدرسة.
• تصدير البيانات: تصدير أنشطة SchoolsBuddy حسب الطالب أو الحدث لعرضها بسلاسة ودمجها مع الأنظمة الداخلية الأخرى.
• واجهة برمجة تطبيقات الحضور: قراءة وكتابة سجلات حضور الأحداث برمجيًا للحفاظ على تزامن النظام البيئي لمدرستك بالكامل في الوقت الفعلي.
• تسجيل الطلاب الخارجيين: إضافة وإدارة الطلاب غير الموجودين في نظام معلومات الطلاب بالمدرسة، مثل الطلاب المقبولين مسبقًا، أو الملتحقين بالمدرسة الصيفية، أو المشاركين في برامج الإثراء الخارجية.
• سجلات الموظفين والميسرين: إدارة الموظفين الخارجيين غير الموجودين في نظام معلومات الطلاب، بما في ذلك الميسرين الضيوف والمدربين الخارجيين وقادة الرحلات أو موظفي المنطقة.
• التكامل الافتراضي: تحديث وصيانة معرفات اجتماعات المعلمين عبر الإنترنت لمنصات الاتصال الرقمي التي اختارتها مدرستك.
• إنشاء وإدارة: تفضيلات التسجيل الفوري للكتب، ومجموعات جدولة الأحداث الرياضية أو الرحلات، ومجموعات رسوم الخدمات، وفصول المواد الدراسية لاجتماعات أولياء الأمور والمعلمين (مطلوب فقط إذا لم يكن لديك مصدر آخر لاستيراد البيانات).

التنقل خطوة بخطوة

إعداد عميل واجهة برمجة التطبيقات (API) الخاص بك

إعدادات المسؤول > التكاملات > واجهة برمجة التطبيقات العامة

1. تأكد من تسجيل دخولك كمسؤول رئيسي للمؤسسة، حيث أن هذا الدور مطلوب لتوفير الوصول إلى واجهة برمجة التطبيقات (API).
2. اتبع دليل الإعداد المخصص لتسجيل عميل واجهة برمجة التطبيقات (API) الخاص بك وإنشاء بيانات الاعتماد.
3. قم بتكوين مصادقة OAuth 2.0 لتكاملك باستخدام بيانات الاعتماد المقدمة.
4. راجع نقاط النهاية المتاحة (الطلاب، جهات الاتصال، الموظفين، الأحداث، المواقع، المجموعات، التسجيلات) في وثائق Swagger قبل إنشاء مكالماتك الأولى.
5. اختبر عملية التكامل الخاصة بك على مجموعة بيانات غير إنتاجية كلما أمكن ذلك قبل إطلاق مزامنة البيانات المباشرة.

تتوفر تعليمات الإعداد الكاملة هنا: كيفية إعداد واجهة برمجة التطبيقات العامة SchoolsBuddy .

نصائح وأفضل الممارسات

• الأمان أولاً: استخدم معيار المصادقة OAuth 2.0 المقدم لضمان الوصول الآمن إلى بياناتك.
• مراجعة الوثائق: يجب على المطورين الرجوع إلى بوابة التكاملات وصفحة Swagger للاطلاع على مواصفات نقطة النهاية الكاملة وإرشادات المصادقة.
• الكفاءة: استخدم بيانات الترقيم الوصفية لاسترجاع البيانات بكفاءة عند التعامل مع مجموعات البيانات الكبيرة.

تحذيرات وملاحظات هامة

مقالات ذات صلة

• كيفية إعداد واجهة برمجة تطبيقات SchoolsBuddy العامة
• إدارة صلاحيات المشرف الرئيسي للمؤسسة

الأسئلة الشائعة

ما هي طريقة المصادقة المستخدمة؟

تستخدم واجهة برمجة التطبيقات (API) مصادقة OAuth 2.0 لضمان معايير الأمان الحديثة لجميع عمليات التكامل.

هل الوثائق الفنية متوفرة؟

نعم، تتوفر وثائق المطورين الشاملة، بما في ذلك تعريفات OpenAPI/Swagger، عبر بوابة التكامل .

من يستطيع إعداد الوصول إلى واجهة برمجة التطبيقات (API)؟

لا يمكن إلا للمسؤولين الرئيسيين في المؤسسة توفير إمكانية الوصول إلى عميل واجهة برمجة التطبيقات، مما يحافظ على أمان التكامل تحت سيطرة محكمة.

في ملخص

• تربط واجهة برمجة التطبيقات (API) SchoolsBuddy بالأنظمة الداخلية أو أنظمة الجهات الخارجية لأتمتة عمليات سير البيانات.
• وهي تغطي حاليًا الطلاب والموظفين والفعاليات والمواقع والمجموعات والتفضيلات والتسجيلات الفورية للكتب.
• يتم توفير الوصول حصريًا من قبل كبار المسؤولين في المؤسسة عبر بروتوكول OAuth 2.0.

عزز كفاءة التشغيل في مدرستك باستخدام واجهة برمجة التطبيقات العامة SchoolsBuddy .