مشاركة عبر

نظرة عامة على ميزة واجهة برمجة تطبيقات كتالوج Microsoft Learn

  • مقالة

واجهة برمجة تطبيقات كتالوج Microsoft Learn هي واجهة برمجة تطبيقات ويب مستندة إلى REST تتيح لك إرسال استعلام مستند إلى الويب إلى Microsoft Learn والحصول على تفاصيل حول محتوى التدريب المتوفر واختبارات الشهادة مثل العناوين والمنتجات المغطاة والمستويات والارتباطات إلى التدريب وبيانات التعريف الأخرى وإرجاع استجابة مشفرة بواسطة JSON بالمعلومات.

تقوم بإرجاع معلومات حول كل ما هو متوفر للعامة:

  • الوحدات
  • Units
  • مسارات التعلم
  • المهارات التطبيقية
  • الشهادات
  • اختبارات
  • الدورات التدريبية بقيادة مدرب

إشعار

كجزء من تحديث موقع Microsoft Learn الأخير، تتوفر نقطة نهاية جديدة لواجهة برمجة تطبيقات الكتالوج على مجال learn.microsoft.com. ستظل نقطة النهاية القديمة تعمل كما هو متوقع، ولكن فوائد التبديل إلى نقطة النهاية الجديدة هي أنها ستمنحك ميزات محسنة مثل معلمات الاستعلام الإضافية.

حالات الاستخدام

  • عرض بيانات التعريف حول التدريب على Microsoft Learn و/أو عروض الشهادات
  • اسحب قائمة بعروض التدريب و/أو الشهادات من Microsoft Learn للارتباط بها من تجربتك الخاصة عبر الإنترنت

كيفية عمل واجهة برمجة تطبيقات كتالوج Learn

واجهة برمجة التطبيقات هي واجهة برمجة تطبيقات ويب تستند إلى REST تقوم بإرجاع استجابة مشفرة من JSON. لطلب الكتالوج الكامل، أرسل طلب GET إلى:

https://learn.microsoft.com/api/catalog/

سيبدو الإخراج مشابها للقطة الشاشة أدناه. اعتبارا من نوفمبر 2022، تبلغ الاستجابة الكاملة حوالي 13 ميغابايت.

Screenshot of the Learn Catalog API output in Visual Studio Code.

كل عنصر كتالوج التعلم هو عنصر، مع مجموعة من بيانات التعريف المتاحة لكل منها. يتم سرد قاموس البيانات الكامل والخيارات الأخرى في وثائق مطور واجهة برمجة تطبيقات كتالوج Microsoft Learn. لدينا أيضا ملاحظات حول الإصدار (ارتباط) لمعرفة آخر التحديثات ومعلومات أفضل الممارسات .

إذا كنت مهتما باستخدامه، فراجع مقالة بدء استخدام واجهة برمجة تطبيقات كتالوج Microsoft Learn باستخدام cURL وVisual Studio Code.

المتطلبات

لا توجد مصادقة مطلوبة للوصول إلى واجهة برمجة تطبيقات كتالوج Microsoft Learn. يمكن للمستخدمين استخدام أسلوب طلب واجهة برمجة التطبيقات المفضلة لديهم، مثل cURL وPostman وما إلى ذلك.

الأمثلة

فيما يلي بعض الطرق العديدة التي نراها للمستخدمين باستخدام واجهة برمجة تطبيقات كتالوج Learn:

  • استخدمت Viva Learning واجهة برمجة تطبيقات كتالوج Learn لتقديم كتالوج Microsoft Learn كجزء من تجربتها الأساسية.
  • تستخدم المؤسسات والمؤسسات التعليمية واجهة برمجة تطبيقات كتالوج Learn لسحب معلومات الكتالوج ونشرها في أنظمة إدارة التعلم الداخلية (LMS)، حتى يتمكن موظفوها والطلاب من الوصول إليها بسهولة.
  • يستخدم موفرو التعلم واجهة برمجة تطبيقات كتالوج Learn لسحب معلومات الكتالوج ونشرها في تجارب تعلم العملاء الخاصة بهم.

التوفر والتسعير

واجهة برمجة تطبيقات كتالوج Microsoft Learn متاحة للجمهور ويتم تقديمها بموجب شروط استخدام واجهات برمجة تطبيقات Microsoft. لا توجد رسوم لاستخدام واجهة برمجة التطبيقات.

القيود

  • تحتوي واجهة برمجة التطبيقات على وحدات نمطية ووحدات ومسارات تعليمية ودورات تدريبية بقيادة مدرب واختبارات وشهادات متاحة للجمهور. لا يقوم إخراج الوثائق أو نماذج التعليمات البرمجية أو العروض أو الأحداث في الوقت الحالي.
  • تقوم واجهة برمجة التطبيقات بتحديث مرة واحدة على الأقل في اليوم.
  • سيتم توصيل التحديثات إلى إصدار واجهة برمجة التطبيقات عبر التحديثات إلى تعلم ملاحظات إصدار واجهة برمجة تطبيقات الكتالوج.

الخطوات التالية

لمعرفة المزيد حول واجهة برمجة تطبيقات كتالوج Learn، راجع المقالات التالية: