تعرض واجهات برمجة تطبيقات Brightspace الوظائف للسماح للمستخدمين بإضافة محتوى وإزالته من المقررات الدراسية. توضح الأمثلة التالية كيف يمكن استخدام واجهات برمجة التطبيقات هذه لإنشاء مخطط تفصيلي قياسي لمقرر دراسي.
لنفترض أن جميع المقررات الدراسية يجب أن تحتوي على الوحدات التالية:
- مقدمة
- مخطط الوسم
- استعراض منتصف المدة
- مراجعة الاختبار
إذا كانت لدينا قائمة بالدورات التدريبية المحددة من خلال معرف الوحدة التنظيمية الخاصة بهم ، فيمكننا التحقق لمعرفة ما إذا كان هناك أي محتوى مخصص وتعديلها كما هو مطلوب.
يمكننا الرجوع إلى وثائق التكافؤ للطرق التي تتيح لنا التلاعب بالمسار محتوى.
أولا ، سنقوم باسترداد المحتوى الحالي لمقرر دراسي بمعرف وحدة المؤسسة 121535.
GET /d2l/api/le/1.0/121535/content/root/200 OK[{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": 97657,"Title": "Customs","ShortTitle": ","Type": 0}]
يبدو أن هناك بالفعل وحدة نمطية تم إنشاؤها لهذه الدورة التدريبية. دعنا نحذفه قبل أن نضيف الوحدات الخاصة بنا.
حذف /d2l/api/le/1.0/121535/content/modules/97657200 موافق
إذا أعدنا التحقق من جذر محتوى الدورة التدريبية ، فيجب أن نتلقى مصفوفة فارغة.
الحصول على / d2l / api / le/1.0 / 121535 / content / root / 200 موافق []
نحن الآن جاهزون لإضافة وحداتنا الخاصة.
POST /d2l/api/le/1.. 0/121535/content/root/{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": null,"Title": "Mark", "ShortTitle": "","Type": 0}200 OKPOST /d2l/api/le/1.0/121535/content/root/{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": null,"Title": "Introduction","ShortTitle": ""","Type": 0}200 OKPOST /d2l/api/le/1.0/121535/content/root/{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": null,"Title": "مراجعة منتصف المدة","ShortTitle": "","النوع": 0}200 OKPOST /d2l/api/le/1.0/121535/content/root/{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": null,"Title": "مراجعة الامتحان","ShortTitle": ""","النوع": 0}200 موافق
الآن يمكننا إعادة التحقق من جذر محتوى المقرر الدراسي واسترداد معرفات الوحدة النمطية. (إذا كنت تجري مكالمات مقابل الإصدار 10.2.0 بيئة التعلم أو إصدار أحدث، فيجب أن ترجع الاستدعاءات لإنشاء الموضوعات والوحدات النمطية إليك معلومات حول كل بنية أثناء إنشائها، بحيث ستحصل على قيمة الوحدة النمطية أو معرف الموضوع في تلك المرحلة.)
احصل على /d2l/api/le/1.. 0/121535/content/root/200 OK[{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": 97657,"Title": "Introduction","ShortTitle": ""","Type": 0},{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": 97658,"Title": "Marking Scheme","ShortTitle": ""","Type": 0},{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false," Id": 97659,"Title": "مراجعة منتصف المدة","ShortTitle": "","النوع": 0},{"Structure": [],"ModuleStartDate": null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": 97660,"Title": "مراجعة الامتحان","ShortTitle": ""","النوع": 0}]
الآن تحتوي الدورة التدريبية على مجموعة قياسية من الوحدات التي تم إنشاؤها. دعنا نحدد تاريخي البدء والانتهاء لوحدة المقدمة.
PUT /d2l/api/le/1.0/121535/content/modules/97657{"Structure": [],"ModuleStartDate": "2013-05-20T13:00:00.000Z","ModuleEndDate": "2013-05-24T22:00:00.000Z","IsHidden": false,"IsLocked": false,"Id": 97657,"Title": "Introduction","ShortTitle": ""","Type": 0}200 OK
كخطوة أخيرة ، دعنا نضيف وحدة فرعية إلى المقدمة. (تحرير: تم تصحيح المسار أدناه إلى POST ، بدلا من PUT.)
POST /d2l/api/le/1.0/121535/content/modules/97657/structure/{"Structure": [],"ModuleStartDate":null,"ModuleEndDate": null,"IsHidden": false,"IsLocked": false,"Id": null,"Title": "Professor-Student Mixer","ShortTitle": ""","Type": 0}200 OK
يغطي هذا أساسيات معالجة الوحدات النمطية في المقرر الدراسي.