مشاركة عبر


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

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

نقطة نهاية واجهة برمجة التطبيقات

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

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

ملاحظه

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

معلمات الاستعلام

فيما يلي معلمات الاستعلام التي يمكن أن يتضمنها الطلب. كلها اختيارية. يجب عليك ترميز URL لقيم معلمة الاستعلام. يمكنك استخدام نقطة النهاية مع أي من هذه المعلمات أو واحدة أو بعضها أو كلها.

مهم

إذا كنت تستخدم أكثر من واحد، تقييم الاستعلام باستخدام عامل التشغيل AND.

اسم قيمة نوع مطلوب مثل
موقع رمز لغة واحد صالح من قائمة المدعومة من لغة. ستكون بيانات التعريف التي تم إرجاعها في الإعدادات المحلية المطلوبة إذا كانت متوفرة. إذا لم يتم توفير هذه المعلمة، إرجاع استجابة en-us. خيط لا ?locale=en-us
نوع قائمة مفصولة بفواصل لواحد أو أكثر من محتوى المستوى الأعلى أو عناصر التصنيف التي نقدمها حاليا في الاستجابة للعودة. القيم المدعومة هي: modulesunitslearningPathsappliedSkillscertificationsmergedCertificationsexamscourseslevelsrolesproductssubjects. خيط لا ?type=modules,learningPaths
uid قائمة مفصولة بفواصل تضم معرفا فريدا واحدا أو أكثر من المعرفات الفريدة للمحتوى الصالح (uid) من أنواع المحتويات المتوفرة. ملاحظة: uids حساسة لحالة الأحرف. خيط لا ?uid=learn.azure.intro-to-azure-fundamentals
last_modified عامل تشغيل ووقت للتصفية حسب تاريخ آخر تعديل للكائنات. يتضمن عامل التشغيل lt (أقل من) lte (أقل من أو يساوي) eq (يساوي) gt (أكبر من) gte (أكبر من أو يساوي). عند استخدام هذه المعلمة، سيتم تعيين عامل التشغيل افتراضيا إلى gte إذا لم يتم تحديده. خيط لا ?last_modified=gte 2022-01-01
شعبيه عامل تشغيل وقيمة للتصفية حسب قيمة الشعبية (في نطاق من 0 إلى 1) من العناصر. يتضمن عامل التشغيل lt (أقل من) lte (أقل من أو يساوي) eq (يساوي) gt (أكبر من) gte (أكبر من أو يساوي). عند استخدام هذه المعلمة، سيتم تعيين عامل التشغيل افتراضيا إلى gte إذا لم يتم تحديده. خيط لا ?popularity=gte 0.5
مستوى قائمة مفصولة بفواصل لواحد أو أكثر من المستويات المتوفرة لدينا حاليا (توجد القائمة الكاملة في مستويات كائن استجابة واجهة برمجة التطبيقات). خيط لا ?level=beginner
دور قائمة مفصولة بفواصل لواحد أو أكثر من الأدوار المتوفرة لدينا حاليا (توجد القائمة الكاملة في الأدوار عنصر استجابة واجهة برمجة التطبيقات). خيط لا ?role=developer
حاصل الضرب قائمة مفصولة بفواصل لواحد أو أكثر من الأدوار المتوفرة لدينا حاليا (القائمة الكاملة موجودة في المنتجات عنصر استجابة واجهة برمجة التطبيقات). لا تدعم واجهة برمجة التطبيقات التسلسل الهرمي للمنتج، لذا أضف كل منتج إلى القائمة التي تريد تضمينها في استعلامك. خيط لا ?product=azure
موضوع قائمة مفصولة بفواصل لواحد أو أكثر من الأدوار المتوفرة لدينا حاليا (توجد القائمة الكاملة في مواضيع كائن استجابة واجهة برمجة التطبيقات). لا تدعم واجهة برمجة التطبيقات التسلسل الهرمي للموضوع، لذا أضف كل موضوع إلى القائمة التي تريد تضمينها في الاستعلام. خيط لا ?subject=cloud-computing

نماذج الاستعلامات

الاستعلامات المذكورة أدناه هي نماذج لمساعدتك على فهم ما يمكنك طلبه وكيفية تشكيل الطلب.

وصف استفسار
جميع العناصر في واجهة برمجة تطبيقات كتالوج Learn https://learn.microsoft.com/api/catalog/
جميع الوحدات النمطية الإسبانية https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules
جميع الوحدات مع درجة شعبية من 0.9 أو أعلى https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9
جميع التدريبات الأمنية للمبتدئين وعناصر الشهادات https://learn.microsoft.com/api/catalog/?level=beginner&subject=security
جميع وحدات إمكانية وصول ذوي الاحتياجات الخاصة المتقدمة مع درجة شعبية أكثر من 0.5 وتحديثها في الشهر الماضي https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01

استجابة واجهة برمجة التطبيقات

قد ترجع الخدمة رموز حالة HTTP التالية.

رمز الحالة وصف
200 نجاح. يتضمن نص الاستجابة البيانات المشفرة JSON.
400 إحدى معلمات الاستعلام مفقودة أو غير صالحة.
404 لم يتم العثور على عنوان URL على الخادم.
500 خطأ خادم غير متوقع.
503 الخدمة غير متوفرة مؤقتا.

ستتضمن الاستجابة الناجحة تفاصيل حول جميع الوحدات النمطية ومسارات التعلم، كما هو موضح أدناه.

نص الاستجابة

سيتم ترميز نص استجابة ناجح في JSON وسيكون له 12 قسما:

{
    "modules": [ ... ],
    "units": [...],
    "learningPaths": [ ... ],
    "appliedSkills": [ ... ],
    "mergedCertifications": [ ... ],
    "certifications": [ ... ],
    "exams": [ ... ],
    "courses": [ ... ],
    "levels": [ ... ],
    "products": [ ... ],
    "roles": [ ... ],
    "subjects": [...],
}

يحتوي كل صفيف على كائن واحد أو أكثر مرمز JSON يحتوي على بيانات خاصة بهذا القسم من الاستجابة.

  1. modules: هو صفيف من الوحدات النمطية المنشورة.
  2. units: عبارة عن صفيف من الوحدات المنشورة.
  3. learningPaths: عبارة عن مجموعة من مسارات التعلم المنشورة.
  4. appliedSkills: عبارة عن مجموعة من المهارات التطبيقية المنشورة.
  5. mergedCertifications: عبارة عن مجموعة من الشهادات المنشورة المدمجة مع الاختبارات.
  6. certifications: هو صفيف من الشهادات المنشورة.
  7. exams: عبارة عن مجموعة من الاختبارات المنشورة.
  8. courses: عبارة عن مجموعة من الدورات التدريبية المنشورة بقيادة مدرب.
  9. levels: عبارة عن صفيف من مستويات الجمهور المحتملة.
  10. products: عبارة عن مجموعة من المنتجات والخدمات المحتملة التي يغطيها الكتالوج.
  11. roles: هو صفيف من الأدوار الوظيفية المحتملة.
  12. subjects: عبارة عن صفيف من علامات الموضوع المحتملة.

سجلات الوحدة النمطية

سجلات الوحدة النمطية

سيكون لكل سجل وحدة نمطية النموذج التالي:

{
    "summary": "Explore the core concepts of cloud computing and how it can help your business.",
    "levels": [
        "beginner"
    ],
    "roles": [
        "administrator",
        "business-analyst",
        "developer"
    ],
    "products": [
        "azure",
        "azure-portal",
        "azure-resource-manager"
    ],
    "subjects": [
        "data-visualization"
    ],
    "uid": "learn.principles-cloud-computing",
    "type": "module",
    "title": "Cloud Concepts - Principles of cloud computing",
    "duration_in_minutes": 62,
    "rating": {
        count: 2014,
        average: 4.84
    },
    "popularity": 0.8839785477023878, 
    "icon_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing.svg",
    "social_image_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing-social.png",
    "locale": "en-us",
    "last_modified": "2018-09-24T00:00:00Z",
    "url": "https://learn.microsoft.com/learn/modules/principles-cloud-computing",
    "firstUnitUrl": "https://learn.microsoft.com/learn/modules/principles-cloud-computing/1-introduction",
    "units": [
        "learn.principles-cloud-computing.1-introduction",
        "learn.principles-cloud-computing.2-types-of-cloud-computing",
        "learn.principles-cloud-computing.3-benefits-of-cloud-computing",
        "learn.principles-cloud-computing.4-categories-of-cloud-services",
        "learn.principles-cloud-computing.5-knowledge-check",
        "learn.principles-cloud-computing.6-summary"
    ],
    "number_of_children": 6
}

تفاصيل الحقل

ميدان نوع وصف
summary خيط سلسلة توفر وصفا مختصرا للوحدة النمطية. يتم التعبير عن القيمة كعلامة فقرة HTML مع النص الداخلي هو الملخص.
levels صفيف سلاسل قائمة المستويات المرتبطة بهذه الوحدة النمطية، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب هذه الوحدة النمطية. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستوى.
roles صفيف سلاسل قائمة بأدوار الوظيفة التي تتعلق بها هذه الوحدة النمطية.
products صفيف سلاسل قائمة بالمنتجات ذات الصلة التي تغطيها هذه الوحدة. يمكن الرجوع إلى تفاصيل المنتجات في سجلات المنتجات.
subjects صفيف سلاسل قائمة بالمواضيع ذات الصلة التي يغطيها مسار التعلم هذا.
uid خيط معرف فريد لهذه الوحدة النمطية - ستكون هذه القيمة فريدة عبر جميع MS Learn.
type خيط نوع السجل. ستكون القيمة دائما "وحدة نمطية".
title خيط عنوان الوحدة النمطية في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
duration_in_minutes العدد الصحيح متوسط الوقت الذي تستغرقه هذه الوحدة لإكمالها بالدقائق.
rating كائن يحتوي على كل من count، وهو عدد الأشخاص الذين قاموا بتصنيف الوحدة النمطية، average، وهو مجموع التقييمات، والذي سيكون من 1 إلى 5
popularity مزدوج قيمة تمت تسويتها من 0-1 تشير إلى شعبية الوحدة
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 تمثل صورة إنجاز الوحدة النمطية بخلفية شفافة.
social_image_url خيط عنوان URL مؤهل بالكامل لصورة PNG تمثل صورة إنجاز الوحدة النمطية بخلفية مبهمة مستطيلة، مناسبة لتجارب الوسائط الاجتماعية أو التجانب. إذا لم تكن متوفرة لهذه الوحدة النمطية، فلن يتم إرجاع هذه الخاصية في الاستجابة.
locale خيط اللغة التي تكتب بها بيانات JSON هذه. ستكون هذه القيمة الإعدادات المحلية المطلوبة إذا كانت متوفرة، أو 'en-us' إن لم يكن الأمر.
last_modified تاريخ في المرة الأخيرة التي تم فيها إجراء مراجعة رئيسية لهذه الوحدة النمطية.
url خيط عنوان URL مؤهل بالكامل للوحدة النمطية Learn في اللغة المطلوبة.
firstUnitUrl خيط عنوان URL مؤهل بالكامل للوحدة الأولى من وحدة Learn في اللغة المطلوبة.
units صفيف سلاسل قائمة بواجهة مستخدم الوحدة المقترنة. يمكن الرجوع إلى تفاصيل الوحدات في سجلات الوحدة.
number_of_children العدد الصحيح عدد الصفحات (الوحدات) التي تحتوي عليها هذه الوحدة النمطية.

سجلات الوحدات

سيكون لكل سجل وحدة النموذج التالي:

{
    "uid": "learn.azure.fundamental-azure-concepts.types-of-cloud-computing",
    "type": "unit",
    "title": "Discuss different types of cloud models",
    "duration_in_minutes": 5,
    "locale": "en-us",
    "last_modified": "2021-12-09T02:45:00+00:00"
},

ملاحظه

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

تفاصيل الحقل

ميدان نوع وصف
uid خيط معرف فريد لهذه الوحدة النمطية - ستكون هذه القيمة فريدة عبر جميع MS Learn.
type خيط نوع السجل. ستكون القيمة دائما "وحدة".
title خيط عنوان الوحدة في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
duration_in_minutes مدة الوحدة. إذا أضفت جميع duration_in_minutes من الوحدات المقترنة بكل وحدة نمطية، فستحصل على إجمالي وقت الوحدة النمطية.
locale خيط اللغة التي تكتب بها بيانات JSON هذه. ستكون هذه القيمة الإعدادات المحلية المطلوبة إذا كانت متوفرة، أو 'en-us' إن لم يكن الأمر.
last_modified تاريخ في المرة الأخيرة التي تم فيها إجراء مراجعة رئيسية لهذه الوحدة النمطية.

سجلات مسار التعلم

سيكون لكل سجل مسار تعلم النموذج التالي:

{
    "summary": "Azure Functions enable the creation of event driven, compute-on-demand systems that can be triggered by various external events. Learn how to leverage functions to execute server-side logic and build serverless architectures.",
    "levels": [
        "beginner",
        "intermediate"
    ],
    "roles": [
        "developer",
        "solution-architect"
    ],
    "products": [
        "azure",
        "azure-portal",
        "azure-functions",
        "azure-cosmos-db",
        "azure-cloud-shell"
    ],
    "subjects": [
        "data-visualization"
    ],
    "uid": "learn.create-serverless-applications",
    "type": "learningPath",
    "title": "Create serverless applications",
    "duration_in_minutes": 450,
    "rating": {
        count: 2014,
        average: 4.84
    },
    "popularity": 0.8839785477023878, 
    "icon_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications.svg",
    "social_image_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications-social.png",
    "locale": "en-us",
    "last_modified": "2018-12-27T00:00:00Z",
    "url": "https://learn.microsoft.com/learn/paths/create-serverless-applications",
    "firstModuleUrl": "https://learn.microsoft.com/learn/modules/choose-azure-service-to-integrate-and-automate-business-processes/",
    "modules": [
        "learn.choose-azure-service-to-integrate-and-automate-business-processes",
        "learn.create-serverless-logic-with-functions",
        "learn.execute-azure-function-with-triggers",
        "learn.chain-azure-functions-data-using-input-output-bindings",
        "learn.azure-create-long-running-serverless-workflow-with-durable-functions",
        "learn-pr.develop-test-deploy-azure-functions-core-tools",
        "learn.develop-test-deploy-azure-functions-with-visual-studio",
        "learn.azure.monitor-github-events-with-a-function-triggered-by-a-webhook",
        "learn.advocates.azure-functions-and-signalr"
    ],
    "number_of_children": 9
}

تفاصيل الحقل

ميدان نوع وصف
summary خيط سلسلة توفر وصفا مختصرا لمسار التعلم. يتم التعبير عن القيمة كعلامة فقرة HTML مع النص الداخلي هو الملخص.
levels صفيف سلاسل قائمة المستويات المرتبطة بمسار التعلم هذا، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب مسار التعلم هذا. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستوى.
roles صفيف سلاسل قائمة بأدوار الوظيفة ذات الصلة لمسار التعلم هذا.
products صفيف سلاسل قائمة بالمنتجات ذات الصلة التي يغطيها مسار التعلم هذا. يمكن الرجوع إلى تفاصيل المنتجات في سجلات المنتجات.
subjects صفيف سلاسل قائمة بالمواضيع ذات الصلة التي يغطيها مسار التعلم هذا.
uid خيط معرف فريد لمسار التعلم هذا - ستكون هذه القيمة فريدة عبر جميع MS Learn.
type خيط نوع السجل. ستكون القيمة دائما "learningPath".
title خيط عنوان مسار التعلم في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
duration_in_minutes العدد الصحيح متوسط الوقت الذي يستغرقه مسار التعلم هذا لإكماله في دقائق. هذه القيمة هي مجموع بيانات من جميع الوحدات النمطية المضمنة.
rating كائن يحتوي على كل من count، وهو عدد الأشخاص الذين قاموا بتصنيف مسار التعلم، average، وهو مجموع التقييمات، والذي سيكون من 1 إلى 5
popularity مزدوج قيمة تمت تسويتها من 0-1 تشير إلى شعبية مسار التعلم
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 تمثل مسار التعلم.
social_image_url خيط عنوان URL مؤهل بالكامل لصورة PNG تمثل صورة إنجاز مسار التعلم بخلفية مبهمة مستطيلة، مناسبة لتجارب الوسائط الاجتماعية أو التجانب. إذا لم تكن متوفرة لهذه الوحدة النمطية، فلن يتم إرجاع هذه الخاصية في الاستجابة.
locale خيط اللغة التي تكتب بها بيانات JSON هذه. ستكون هذه القيمة الإعدادات المحلية المطلوبة إذا كانت متوفرة، أو 'en-us' إن لم يكن الأمر.
last_modified تاريخ آخر مرة تم فيها تغيير مسار التعلم هذا.
url خيط عنوان URL مؤهل بالكامل لمسار التعلم في Microsoft Learn في اللغة المطلوبة.
firstModuleUrl خيط عنوان URL مؤهل بالكامل للوحدة النمطية الأولى من مسار التعلم في Microsoft Learn في اللغة المطلوبة.
modules صفيف سلاسل قائمة بواجهة مستخدم الوحدة النمطية المقترنة. يمكن الرجوع إلى تفاصيل الوحدات النمطية في سجلات الوحدة النمطية.
number_of_children العدد الصحيح عدد الوحدات التي يحتوي عليها مسار التعلم هذا.

سجلات المهارات التطبيقية

سيكون لكل سجل من سجلات المهارات التطبيقية النموذج التالي:

{
    "uid": "applied-skill.deploy-and-configure-azure-monitor",
    "locale": "en-us",
    "url": "https://learn.microsoft.com/en-us/credentials/applied-skills/deploy-and-configure-azure-monitor/?WT.mc_id=api_CatalogApi",
    "title": "Deploy and configure Azure Monitor",
    "summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
    "levels": [
        "intermediate"
    ],
    "roles": [
        "administrator"
    ],
    "products": [
        "azure-monitor",
        "azure-virtual-machines",
        "azure-virtual-network",
        "windows-server"
    ],
    "subjects": [
        "it-management-monitoring"
    ],
    "study_guide": [
        {
            "uid": "learn.wwl.deploy-configure-azure-monitor",
            "type": "learningPath"
        }
    ],
    "last_modified": "2023-10-25T17:07:00+00:00"
}

تفاصيل الحقل

ميدان نوع وصف
uid خيط معرف فريد لهذه المهارة التطبيقية - ستكون هذه القيمة فريدة عبر جميع MS Learn.
locale خيط اللغة التي تكتب بها بيانات JSON هذه. ستكون هذه القيمة الإعدادات المحلية المطلوبة إذا كانت متوفرة، أو 'en-us' إن لم يكن الأمر.
title خيط عنوان المهارة التطبيقية في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
summary خيط ملخص المهارة التطبيقية في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
url خيط عنوان URL مؤهل بالكامل للمهارة التطبيقية في Microsoft Learn في اللغة المطلوبة.
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 تمثل المهارة التطبيقية (عند توفرها، وإلا فلن يتم تضمينها).
levels صفيف سلاسل قائمة المستويات المقترنة بهذه المهارة التطبيقية.
roles صفيف سلاسل قائمة بأدوار الوظائف ذات الصلة لهذه المهارة التطبيقية. يمكن الرجوع إلى تفاصيل الأدوار في سجلات الأدوار.
subjects صفيف سلاسل قائمة بالمواضيع ذات الصلة التي تغطيها هذه المهارة التطبيقية.
study_guide صفيف من الكائنات قائمة بالمحتوى المقترن للدراسة لهذه المهارة التطبيقية. يمكن الرجوع إلى تفاصيل الكائنات في السجلات المقترنة بها.
last_modified تاريخ آخر مرة تم فيها تغيير هذه المهارة التطبيقية.

سجلات الشهادات المدمجة

سيكون لكل سجل شهادة مدمج النموذج التالي:

{
    "uid": "certification.d365-functional-consultant-manufacturing",
    "title": "Microsoft Certified: Dynamics 365 Supply Chain Management, Manufacturing Functional Consultant Associate",
    "summary": "<div class=\"WARNING\">\n<p>Warning</p>\n<p>This certification retired on June 30, 2023. You can renew it for at least six months after the retirement date by completing the free online assessment available on the <a href=\"/credentials/certifications/d365-functional-consultant-manufacturing/renew\">certification renewal page</a>. <a href=\"https://aka.ms/BACertPortfolioUpdatesBlog\">Read the blog post</a>.</p>\n</div>\n<p>If you’re a functional consultant or a business user with a deep understanding of manufacturing industry standards, this certification might be for you. You also need experience configuring and implementing Dynamics 365 Supply Chain Management to meet the needs of your organization. Supply chain management, manufacturing functional consultants are key resources who work with developers, solution architects, project managers, and functional consultants in finance, commerce, and supply chain.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Study the supply chain management and supply chain management, manufacturing modules on Microsoft Learn, and complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course that covers the MB-300 or MB-320 track.</li>\n<li>Take part in the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>, or join a user group.</li>\n<li>Shadow a manufacturing functional consultant in a manufacturing workstream.</li>\n<li>Get a mentor, tour manufacturing lines, and learn how things are made.</li>\n<li>Ask questions, and learn from experts and customers.</li>\n</ul>\n",
    "url": "https://learn.microsoft.com/en-us/credentials/certifications/d365-functional-consultant-manufacturing/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/en-us/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
    "last_modified": "2023-09-19T00:47:00+00:00",
    "type": "cert",
    "certification_type": "role-based",
    "products": [
        "dynamics-365",
        "dynamics-finance"
    ],
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "subjects": [],
    "renewal_frequency_in_days": 0,
    "prerequisites": [],
    "skills": [
        "Describe finance and operations apps, and extend apps by using Microsoft Power Platform technologies",
        "Configure administrative features and workflows",
        "Manage finance and operations data",
        "Validate and support solutions",
        "Configure Dynamics 365 Supply Chain Management, Manufacturing",
        "Manage manufacturing processes",
        "Implement master planning for production",
        "Implement other manufacturing features"
    ],
    "recommendation_list": [],
    "study_guide": [],
    "exam_duration_in_minutes": 0,
    "locales": [],
    "providers": [],
    "career_paths": []
}

تفاصيل الحقل

ميدان نوع وصف
uid خيط معرف فريد لهذه الشهادة - ستكون هذه القيمة فريدة عبر جميع MS Learn.
title خيط عنوان الشهادة في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
summary خيط ملخص الشهادة باللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
url خيط عنوان URL مؤهل بالكامل للشهادة في Microsoft Learn في اللغة المطلوبة.
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 التي تمثل الشهادة.
last_modified تاريخ آخر مرة تم فيها تغيير هذه الشهادة.
type خيط نوع السجل. ستكون القيمة دائما "شهادة".
certification_type خيط نوع الشهادة. القيم المحتملة هي "الأساسيات" و"mce" و"mcsa" و"mcsd" و"mcse" و"mos" و"mta" و"role-based" و"specialty".
products صفيف سلاسل قائمة بالمنتجات ذات الصلة التي تغطيها هذه الشهادة. يمكن الرجوع إلى تفاصيل المنتجات في سجلات المنتجات.
levels صفيف سلاسل قائمة بالمستويات المرتبطة بهذه الشهادة، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب اختبارات هذه الشهادة. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستوى.
roles صفيف سلاسل قائمة بأدوار الوظائف ذات الصلة لهذه الشهادة. يمكن الرجوع إلى تفاصيل الأدوار في سجلات الأدوار.
subjects صفيف سلاسل قائمة بالمواضيع ذات الصلة التي تغطيها هذه الشهادة.
renewal_frequency_in_days العدد الصحيح عدد الأيام قبل انتهاء صلاحية هذه الشهادة ويجب تجديدها. إذا كانت القيمة 0، فلن تنتهي صلاحية الشهادة.
prerequisites صفيف سلاسل قائمة بالمتطلبات المسبقة الموصى بها للحصول على هذه الشهادة. يمكن الرجوع إلى تفاصيل الشهادات في سجلات الشهادات.
skills صفيف سلاسل قائمة بالمهارات التي تم قياسها في الاختبار المطلوب لهذه الشهادة.
recommendation_list صفيف سلاسل قائمة بالتوصيات المتعلقة بهذه الشهادة.
study_guide صفيف من الكائنات قائمة بالمحتوى المرتبط للدراسة لهذه الشهادة. يمكن الرجوع إلى تفاصيل الكائنات في السجلات المقترنة بها.
exam_duration_in_minutes العدد الصحيح عدد الدقائق المخصصة لإكمال الامتحان.
locales صفيف سلاسل قائمة باللغات التي يتم تقديم هذه الشهادة بها.
providers صفيف من الكائنات قائمة بموفري هذه الشهادة. يصف النوع الموفر وعنوان URL المؤهل بالكامل مع رابط لجدولة اختبار مع الموفر.
career_paths صفيف من الكائنات قائمة المسارات الوظيفية لهذه الشهادة.

ملاحظه

سيتم إرجاع الشهادات التي تتطلب اختبارا واحدا فقط كجزء من خاصية mergedCertifications هذه.

سجلات الشهادات

سيكون لكل سجل شهادة النموذج التالي:

{
    "uid": "certification.d365-functional-consultant-customer-service",
    "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate",
    "subtitle": "Microsoft Dynamics 365 Customer Service functional consultants are responsible for implementing omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction.",
    "url": "https://learn.microsoft.com/cert-exam-sandbox/cert/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
    "type": "cert",
    "certification_type": "role-based",
    "exams": [
        "exam.77-881"
    ],
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "study_guide": [
        {
            "uid": "learn.get-started-with-d365",
            "type": "module"
        },
        {
            "uid": "learn.d365-notebook",
            "type": "module"
        },
        {
            "uid": "learn.d365-fundamentals",
            "type": "learningPath"
        }
    ]
}

تفاصيل الحقل

ميدان نوع وصف
uid خيط معرف فريد لهذه الشهادة - ستكون هذه القيمة فريدة عبر جميع MS Learn.
title خيط عنوان الشهادة في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
subtitle خيط العنوان الفرعي للشهادة في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
url خيط عنوان URL مؤهل بالكامل للشهادة في Microsoft Learn في اللغة المطلوبة.
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 التي تمثل الشهادة.
type خيط نوع السجل. ستكون القيمة دائما "شهادة".
certification_type خيط نوع الشهادة. القيم المحتملة هي "الأساسيات" و"mce" و"mcsa" و"mcsd" و"mcse" و"mos" و"mta" و"role-based" و"specialty".
exams صفيف سلاسل قائمة بالاختبارات المرتبطة المطلوبة لهذه الشهادة. يمكن الرجوع إلى تفاصيل الوحدات في سجلات الشهادات.
levels صفيف سلاسل قائمة بالمستويات المرتبطة بهذه الشهادة، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب اختبارات هذه الشهادة. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستوى.
roles صفيف سلاسل قائمة بأدوار الوظائف ذات الصلة لهذه الشهادة. يمكن الرجوع إلى تفاصيل الأدوار في سجلات الأدوار.
study_guide صفيف من الكائنات قائمة بالمحتوى المرتبط للدراسة لهذه الشهادة. يمكن الرجوع إلى تفاصيل الكائنات في السجلات المقترنة بها.

ملاحظه

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

سجلات الاختبار

سيكون لكل سجل امتحان النموذج التالي:

{
    "uid": "exam.77-881",
    "title": "Word 2010",
    "subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
    "display_name": "77-881",
    "url": "https://learn.microsoft.com/cert-exam-sandbox/exam/77-881/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
    "pdf_download_url": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
    "practice_test_url": "https://www.mindhub.com/70-413-Designing-and-Implementing-a-Server-Infrast-p/mu-70-413_p.htm?utm_source=microsoft&amp;utm_medium=certpage&amp;utm_campaign=msofficialpractice",
    "practice_assessment_url": "https://learn.microsoft.com/en-us/certifications/exams/{exam}/practice/assessment?assessment-type=practice&assessmentId={assessmentId}",
    "locales": [],
    "type": "exam",
    "courses": [
        "course.pl-200t00",
        "course.mb-230t01"
    ],
    "levels": [
        "beginner"
    ],
    "roles": [
        "business-user"
    ],
    "products": [
        "office-word"
    ],
    "providers": [],
    "study_guide": [
        {
            "uid": "learn.get-started-with-word-2010",
            "type": "module"
        },
        {
            "uid": "learn.office2010-notebook",
            "type": "module"
        },
        {
            "uid": "learn.office2010-fundamentals",
            "type": "learningPath"
        }
    ]
}

تفاصيل الحقل

ميدان نوع وصف
uid خيط معرف فريد لهذا الاختبار - ستكون هذه القيمة فريدة عبر جميع MS Learn.
title خيط عنوان الامتحان باللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
subtitle خيط العنوان الفرعي للامتحان باللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
display_name خيط اسم العرض للامتحان في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
url خيط عنوان URL مؤهل بالكامل للامتحان في Microsoft Learn في اللغة المطلوبة.
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 تمثل الاختبار.
pdf_download_url خيط عنوان URL مؤهل بالكامل لملف PDF يحدد المهارات التي يقاس بها هذا الاختبار.
practice_test_url خيط عنوان URL مؤهل بالكامل لاختبار التدريب المرتبط بالاختبار.
practice_assessment_url خيط عنوان URL مؤهل بالكامل لتقييم الممارسة المجانية المرتبطة بالامتحان.
locales صفيف سلاسل قائمة باللغات التي يتم تقديم هذا الاختبار بها.
type خيط نوع السجل. ستكون القيمة دائما "اختبار".
courses صفيف سلاسل قائمة بواجهة مستخدم الدورة التدريبية المقترنة. يمكن الرجوع إلى تفاصيل الدورات التدريبية في سجلات الدورة التدريبية.
levels صفيف سلاسل قائمة المستويات المرتبطة بهذا الاختبار، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب هذا الاختبار. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستوى.
roles صفيف سلاسل قائمة بأدوار الوظيفة ذات الصلة لهذا الاختبار. يمكن الرجوع إلى تفاصيل الأدوار في سجلات الأدوار.
products صفيف سلاسل قائمة بالمنتجات ذات الصلة التي يغطيها هذا الاختبار. يمكن الرجوع إلى تفاصيل المنتجات في سجلات المنتجات.
providers صفيف من الكائنات قائمة بموفري هذا الاختبار. يصف النوع الموفر وعنوان URL المؤهل بالكامل مع رابط لجدولة اختبار مع الموفر.
study_guide صفيف من الكائنات قائمة بالمحتوى المرتبط للدراسة لهذا الاختبار. يمكن الرجوع إلى تفاصيل الكائنات في السجلات المقترنة بها.

سجلات الدورة التدريبية بقيادة مدرب

سيكون لكل سجل دورة تدريبية النموذج التالي:

{
    "uid": "course.mb-230t01",
    "course_number": "MB-230T01",
    "title": "Microsoft Dynamics 365 Customer Service - added non-exist studyguide",
    "summary": "Microsoft Dynamics 365 Customer Service offers any organization an opportunity for customer success. Using tools such as automatic case creation and queue management frees up your time to dedicate it where you can have a greater impact, directly with your customers. Join our team of globally recognized experts as they take you step by step from creating cases to interacting with customers to resolving those cases. Once you’ve resolved those cases you can learn from data analysis the key details to help you resolve similar cases faster or avoid new issues altogether. A Dynamics 365 Customer Engagement Functional Consultant is responsible for performing discovery, capturing requirements, engaging subject matter experts and stakeholders, translating requirements, and configuring the solution and applications. The Functional Consultant implements a solution using out of the box capabilities, codeless extensibility, application and service integrations.",
    "duration_in_hours": 72,
    "url": "https://learn.microsoft.com/cert-exam-sandbox/course/mb-230t01/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/course.svg",
    "locales": [
        "en"
    ],
    "type": "course",
    "certification": "certification.d365-functional-consultant-customer-service",
    "exam": "exam.77-881",
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "products": [
        "dynamics-365"
    ],
    "study_guide": [
        {
            "uid": "learn.align-requirements-in-azure",
            "type": "module"
        },
        {
            "uid": "learn.manage-resources-in-azure",
            "type": "learningPath"
        }
    ]
},

تفاصيل الحقل

ميدان نوع وصف
uid خيط معرف فريد لهذه الدورة التدريبية بقيادة مدرب - ستكون هذه القيمة فريدة عبر جميع MS Learn.
course_number خيط معرف رقم الدورة التدريبية بقيادة مدرب.
title خيط عنوان الدورة التدريبية التي يقودها المدرب باللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية.
summary خيط سلسلة توفر وصفا قصيرا بقيادة المدرب. يتم التعبير عن القيمة كعلامة فقرة HTML مع النص الداخلي هو الملخص.
duration_in_hours العدد الصحيح متوسط الوقت الذي تستغرقه هذه الدورة التدريبية بقيادة مدرب لإكمالها بالساعات.
url خيط عنوان URL مؤهل بالكامل لصفحة تفاصيل الدورة التدريبية بقيادة مدرب في Microsoft Learn في اللغة المطلوبة.
icon_url خيط عنوان URL مؤهل بالكامل لصورة SVG 100x100 تمثل إنجاز الدورة التدريبية بقيادة المدرب.
locales صفيف سلاسل يتم تقديم قائمة باللغات التي تقدمها هذه الدورة التدريبية بقيادة مدرب رسميا. قد يدعم شركاء التعلم اللغات الأخرى.
type خيط نوع السجل. ستكون القيمة دائما "دورة تدريبية" للدورات التدريبية التي يقودها المدرب.
certification خيط الشهادة المقترنة بالدورة التدريبية التي يقودها المدرب.
exam خيط الاختبار المرتبط بالدورة التدريبية التي يقودها المدرب.
levels صفيف سلاسل قائمة بالمستويات المقترنة بهذه الدورة التدريبية التي يقودها المدرب، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب هذه الدورة التدريبية. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستوى.
study_guide صفيف من الكائنات عنوان URL مؤهل بالكامل لملف PDF يحدد المهارات التي تقاس بهذه الشهادة.

سجلات المستوى والمنتج والدور والموضوع

توفر مجموعات levelsproductsrolessubjects أسماء مألوفة للقيم المستخدمة في الوحدة النمطية وبيانات مسار التعلم. جميع المجموعات الأربع لها نفس الشكل:

{
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

ستتطابق id مع قيم المستويات والمنتجات والأدوار والمواضيع المضمنة في إدخالات الكتالوج الأخرى. يوفر name المقترن اسما مناسبا باللغة الإنجليزية للإدخل. صفيف children اختياري ويمكن التسلسل الهرمي للقيم التي لها علاقات فرعية مثل المنتجات.

على سبيل المثال، إليك مجموعة من الأدوار المحتملة:

{
    ...
    "roles": [
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

فيما يلي مثال لمجموعة من المنتجات، مع تضمين الأطفال لتوفير فئة منتج أكثر تحديدا.

{
    ...
    "products": [
        {
            "id": "dotnet",
            "name": ".NET",
            "children": [
                { "id": "dotnet-core", "name": ".NET Core" },
                { "id": "dotnet-standard", "name": ".NET Standard" },
                { "id": "aspnet-core", "name": "ASP.NET Core" },
                { "id": "ef-core", "name": "Entity Framework Core" }
            ]
        },
        {
            "id": "ms-graph",
            "name": "Microsoft Graph"
        },
        {
            "id": "office",
            "name": "Office",
            "children": [
                { "id": "office-365", "name": "Office 365" },
                { "id": "office-add-ins", "name": "Office Add-ins" },
                { "id": "office-teams", "name": "Teams" }
            ]
        },
        {
            "id": "sql-server",
            "name": "SQL Server"
        },
        ...
    ]
}

نماذج التعليمات البرمجية

هناك العديد من الطرق لاستدعاء واجهة برمجة تطبيقات كتالوج Learn، ولكن نماذج التعليمات البرمجية أدناه هي أمثلة على كيفية استخدامها.

jQuery

$(function() {
    var params = {
        locale:'en-us'
    };
    $.ajax({
        url: "https://learn.microsoft.com/api/learn/catalog?" + $.param(params),
            type: "GET"
    }).done(function(data) {
        alert("success");
    }).fail(function(error) {
        alert("error");
    });
})

.NET C#‎

public string GetCatalogData()
{
var client = new WebClient();
client.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko");
var response = client.DownloadString("https://learn.microsoft.com/api/learn/catalog?locale=en-us");
dynamic parsedJson = JsonConvert.DeserializeObject(response);
JsonConvert.SerializeObject(response, Formatting.Indented);
return Convert.ToString(response);
}

PHP باستخدام ملحق cURL

<?php 

// From URL to get webpage contents. 
$url = "https://learn.microsoft.com/api/learn/catalog"; 

// Initialize a CURL session. 
$ch = curl_init(); 

// Return Page contents. 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 
//grab URL and pass it to the variable. 
curl_setopt($ch, CURLOPT_URL, $url); 

$result = curl_exec($ch); 

echo $result;

?>

PYTHON 3 باستخدام مكتبة "الطلبات"


#!/usr/bin/env python3
#Using Python 3.8.2 install 5/6/2020

import requests
import json

#if given error 'response / requests not defined', install requests via 'pip install requests' in the command line

parameters= {"locale": "en-us"}

response = requests.get("https://learn.microsoft.com/api/learn/catalog/", parameters)

#print(response.status_code)

rawJson = response._content

#Create python objects based on the data using json.loads

data = json.loads(rawJson)

print(data)

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

راجع الموارد أدناه لمساعدتك في رحلة التطوير الخاصة بك: