الوثائق المرجعية لمطور واجهة برمجة تطبيقات كتالوج Microsoft Learn
توفر هذه المقالة معلومات للمطورين والمطالبين الذين ينفذون واجهة برمجة تطبيقات كتالوج Microsoft Learn. نوصي أيضا بالتحقق من أفضل ممارسات واجهة برمجة تطبيقات كتالوج Learn وملاحظات الإصدار ومقالات الأسئلة المتداولة لدعم رحلة التطوير الخاصة بك.
نقطة نهاية واجهة برمجة التطبيقات
واجهة برمجة تطبيقات كتالوج Microsoft Learn هي واجهة برمجة تطبيقات ويب مستندة إلى REST تقوم بإرجاع استجابة مشفرة من JSON. لطلب الكتالوج الكامل، أرسل طلب GET إلى:
https://learn.microsoft.com/api/catalog/
إشعار
نقطة النهاية المذكورة أعلاه هي نقطة النهاية الحالية. إذا كنت تستخدم نقطة نهاية قديمة مختلفة، فستظل تعمل كما هو متوقع عند الإلحاق، ولكن فوائد التبديل إلى نقطة النهاية الجديدة هي أنها ستمنحك ميزات محسنة مثل معلمات استعلام إضافية.
معلمات الاستعلام
فيما يلي معلمات الاستعلام التي يمكن أن يتضمنها الطلب. كلها اختيارية. يجب أن URL ترميز قيم معلمات الاستعلام. يمكنك استخدام نقطة النهاية مع أي من هذه المعلمات أو واحدة أو بعضها أو كلها.
هام
إذا كنت تستخدم أكثر من واحد، فسيتم تقييم الاستعلام باستخدام عامل التشغيل AND.
| الاسم | القيمة | النوع | مطلوب | مثال |
|---|---|---|---|---|
| الإعدادات المحلية | رمز لغة واحد صالح من قائمة لغة معتمدة. ستكون البيانات الوصفية التي تم إرجاعها في اللغة المطلوبة إذا كانت متوفرة. إذا لم يتم توفير هذه المعلمة en-us ، فسيتم إرجاع الاستجابة. |
سلسلة | لا | ?locale=en-us |
| type | قائمة مفصولة بفواصل لواحد أو أكثر من محتوى المستوى الأعلى أو عناصر التصنيف التي نقدمها حاليا في الاستجابة للعودة. القيم المدعومة هي: modules، units، learningPaths، appliedSkills، certifications، mergedCertifications، exams، courses، ، levels، roles، ، products. subjects |
سلسلة | لا | ?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 يحتوي على بيانات خاصة بهذا القسم من الاستجابة.
modules: عبارة عن مجموعة من الوحدات النمطية المنشورة.units: عبارة عن صفيف من الوحدات المنشورة.learningPaths: عبارة عن مجموعة من مسارات التعلم المنشورة.appliedSkills: عبارة عن مجموعة من المهارات التطبيقية المنشورة.mergedCertifications: عبارة عن مجموعة من الشهادات المنشورة المدمجة مع الاختبارات.certifications: عبارة عن صفيف من الشهادات المنشورة.exams: عبارة عن صفيف من الاختبارات المنشورة.courses: عبارة عن صفيف من الدورات التدريبية المنشورة بقيادة مدرب.levels: عبارة عن مجموعة من مستويات الجمهور المحتملة.:products: عبارة عن صفيف من المنتجات والخدمات المحتملة المشمولة في الكتالوج.roles: عبارة عن مجموعة من الأدوار الوظيفية المحتملة.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 |
integer | متوسط الوقت الذي تستغرقه هذه الوحدة بالدقائق. |
rating |
كائن | يحتوي هذا على كليهما count، وهو عدد الأشخاص الذين صنفوا الوحدة، وaverage، مجموع التقييمات التي ستكون من 1 إلى 5 |
popularity |
مزدوج | قيمة عادية من 0-1 تشير إلى شعبية الوحدة النمطية |
icon_url |
سلسلة | عنوان URL مؤهل بالكامل لصورة SVG بحجم 100x100 تمثل صورة إنجاز الوحدة التدريبية بخلفية شفافة. |
social_image_url |
سلسلة | عنوان URL مؤهل بالكامل لصورة PNG تمثل صورة إنجاز الوحدة التدريبية بخلفية مستطيلة غير شفافة، ومناسبة لوسائل التواصل الاجتماعي أو تجارب التجانب. إذا لم تكن متوفرة لهذه الوحدة النمطية، فلن يتم إرجاع هذه الخاصية في الاستجابة. |
locale |
سلسلة | اللغة المكتوب بها بيانات JSON هذه. ستكون هذه القيمة هي المنطقة المطلوبة إذا كانت متوفرة، أو "الإنجليزية-الولايات المتحدة" إذا لم تكن متوفرة. |
last_modified |
date | آخر مرة خضعت هذه الوحدة لمراجعة رئيسية. |
url |
سلسلة | عنوان URL مؤهل بالكامل لوحدة Learn باللغة المحلية المطلوبة. |
firstUnitUrl |
سلسلة | عنوان URL مؤهل بالكامل للوحدة الأولى من وحدة Learn باللغة المحلية المطلوبة. |
units |
صفيف سلاسل | قائمة بالمعرفات الفريدة (UIds) للوحدات المقترنة. يمكن الرجوع إلى تفاصيل الوحدات في سجلات الوحدات. |
number_of_children |
integer | عدد الصفحات (الوحدات) التي تحتوي عليها هذه الوحدة. |
سجلات الوحدات
سيحتوي كل سجل وحدة على النموذج التالي:
{
"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 المقترن لأنه لا تتم كتابة الوحدات كمحتوى مستقل. وهي معدة ليتم أخذها بترتيب معين للوحدة التدريبية. لهذا السبب، نقوم بتضمين الارتباط إلى صفحة تفاصيل الوحدة التدريبية والوحدة الأولى في سجل الوحدة التدريبية حتى يمكن للمستخدمين البدء من هناك ومتابعة المحتوى. ومع ذلك، يمكن استخدام سجلات الوحدات للحصول على تفاصيل حول الوحدات التي سيتم عرضها في أنظمة الإدارة التعليمية (LMS) أو تجارب أخرى.
تفاصيل الحقول
| الحقل | نوع | الوصف |
|---|---|---|
uid |
سلسلة | معرف فريد لهذه الوحدة النمطية - ستكون هذه القيمة فريدة من نوعها عبر كامل MS Learn. |
type |
سلسلة | نوع السجل. ستكون القيمة دائمًا "unit". |
title |
سلسلة | عنوان الوحدة باللغة المحلية المطلوبة، أو بالإنجليزية (الولايات المتحدة) كلغة احتياطية. |
duration_in_minutes |
مدة الوحدة. إذا أضفت جميع duration_in_minutes من الوحدات المقترنة بكل وحدة نمطية، فستحصل على إجمالي وقت الوحدة النمطية. | |
locale |
سلسلة | اللغة المكتوب بها بيانات JSON هذه. ستكون هذه القيمة هي المنطقة المطلوبة إذا كانت متوفرة، أو "الإنجليزية-الولايات المتحدة" إذا لم تكن متوفرة. |
last_modified |
date | آخر مرة خضعت هذه الوحدة لمراجعة رئيسية. |
سجلات مسار التعلم
سيحتوي كل سجل مسار تعلم على النموذج التالي:
{
"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 |
سلسلة | نوع السجل. ستكون القيمة دائمًا 'مسار تعلم'. |
title |
سلسلة | مطلوب عنوان مسار التعلم في اللغة المحلية ، أو الإنجليزية الأمريكية كخيار احتياطي. |
duration_in_minutes |
integer | متوسط الوقت الذي يستغرقه هذا المسار التعليمي لإكماله في دقائق. هذه القيمة هي مجموع البيانات من كافة الوحدات النمطية المضمنة. |
rating |
كائن | يحتوي هذا على كليهما count، وهو عدد الأشخاص الذين صنفوا مسار التعلم، وaverage، مجموع التقييمات التي ستكون من 1 إلى 5 |
popularity |
مزدوج | قيمة عادية من 0-1 تشير إلى شعبية مسار التعلم |
icon_url |
سلسلة | عنوان URL مؤهل بالكامل لصورة SVG بحجم 100x100 تمثل مسار التعلم. |
social_image_url |
سلسلة | عنوان URL مؤهل بالكامل لصورة PNG تمثل صورة إنجاز مسار التعلم بخلفية مستطيلة غير شفافة، ومناسبة لوسائل التواصل الاجتماعي أو تجارب التجانب. إذا لم تكن متوفرة لهذه الوحدة النمطية، فلن يتم إرجاع هذه الخاصية في الاستجابة. |
locale |
سلسلة | اللغة المكتوب بها بيانات JSON هذه. ستكون هذه القيمة هي المنطقة المطلوبة إذا كانت متوفرة، أو "الإنجليزية-الولايات المتحدة" إذا لم تكن متوفرة. |
last_modified |
date | آخر مرة تم فيها تغيير مسار التعلم هذا. |
url |
سلسلة | URL مؤهل بالكامل إلى مسار التعلم في تعلم Microsoft في الإعدادات المحلية المطلوبة. |
firstModuleUrl |
سلسلة | عنوان URL مؤهل بالكامل للوحدة النمطية الأولى من مسار التعلم في Microsoft Learn في اللغة المطلوبة. |
modules |
صفيف سلاسل | قائمة بالمعرفات الفريدة (UIds) للوحدات التدريبية المقترنة. يمكن الرجوع إلى تفاصيل الوحدات التدريبية في سجلات الوحدات التدريبية. |
number_of_children |
integer | عدد الوحدات النمطية التي يحتوي عليها مسار التعلم هذا. |
سجلات المهارات التطبيقية
سيكون لكل سجل من سجلات المهارات التطبيقية النموذج التالي:
{
"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 هذه. ستكون هذه القيمة هي المنطقة المطلوبة إذا كانت متوفرة، أو "الإنجليزية-الولايات المتحدة" إذا لم تكن متوفرة. |
title |
سلسلة | عنوان المهارة التطبيقية في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية. |
summary |
سلسلة | ملخص المهارة التطبيقية في اللغة المحلية المطلوبة، أو الإنجليزية الأمريكية كلغة احتياطية. |
url |
سلسلة | عنوان URL مؤهل بالكامل للمهارة التطبيقية في Microsoft Learn في اللغة المطلوبة. |
icon_url |
سلسلة | عنوان URL مؤهل بالكامل لصورة SVG 100x100 تمثل المهارة التطبيقية (عند توفرها، وإلا فلن يتم تضمينها). |
levels |
صفيف سلاسل | قائمة المستويات المقترنة بهذه المهارة التطبيقية. |
roles |
صفيف سلاسل | قائمة بأدوار الوظائف ذات الصلة لهذه المهارة التطبيقية. يمكن الرجوع إلى تفاصيل الأدوار في سجلات الأدوار. |
subjects |
صفيف سلاسل | قائمة بالمواضيع ذات الصلة التي تغطيها هذه المهارة التطبيقية. |
study_guide |
صفيف من الكائنات | قائمة بالمحتوى المقترن للدراسة لهذه المهارة التطبيقية. يمكن الرجوع إلى تفاصيل الكائنات في السجلات المقترنة بها. |
last_modified |
date | آخر مرة تم فيها تغيير هذه المهارة التطبيقية. |
سجلات الشهادات المدمجة
سيكون لكل سجل شهادة مدمج النموذج التالي:
{
"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 |
date | آخر مرة تم فيها تغيير هذه الشهادة. |
type |
سلسلة | نوع السجل. ستكون القيمة دائمًا "cert". |
certification_type |
سلسلة | نوع الشهادة. القيم المحتملة هي 'fundamentals'، 'mce'، 'mcsa'، 'mcsd'، 'mcse'، 'mos'، 'mta'، 'role-based'، 'specialty'. |
products |
صفيف سلاسل | قائمة بالمنتجات ذات الصلة التي تغطيها هذه الشهادة. يمكن الرجوع إلى تفاصيل المنتجات في سجلات المنتجات. |
levels |
صفيف سلاسل | قائمة بالمستويات المقترنة بهذه الشهادة، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب اختبارات هذه الشهادة. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستويات. |
roles |
صفيف سلاسل | قائمة بالأدوار الوظيفية ذات الصلة لهذه الشهادة. يمكن الرجوع إلى تفاصيل الأدوار في سجلات الأدوار. |
subjects |
صفيف سلاسل | قائمة بالمواضيع ذات الصلة التي تغطيها هذه الشهادة. |
renewal_frequency_in_days |
integer | عدد الأيام قبل انتهاء صلاحية هذه الشهادة ويجب تجديدها. إذا كانت القيمة 0، فلن تنتهي صلاحية الشهادة. |
prerequisites |
صفيف سلاسل | قائمة بالمتطلبات المسبقة الموصى بها للحصول على هذه الشهادة. يمكن الرجوع إلى تفاصيل الشهادات في سجلات الشهادات. |
skills |
صفيف سلاسل | قائمة بالمهارات التي تم قياسها في الاختبار المطلوب لهذه الشهادة. |
recommendation_list |
صفيف سلاسل | قائمة بالتوصيات المتعلقة بهذه الشهادة. |
study_guide |
صفيف من الكائنات | قائمة بالمحتوى المقترن المراد دراسته لهذه الشهادة. يمكن الرجوع إلى تفاصيل الكائنات في السجلات المقترنة بها. |
exam_duration_in_minutes |
integer | عدد الدقائق المخصصة لإكمال الامتحان. |
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 |
سلسلة | نوع السجل. ستكون القيمة دائمًا "cert". |
certification_type |
سلسلة | نوع الشهادة. القيم المحتملة هي 'fundamentals'، '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&utm_medium=certpage&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 |
سلسلة | نوع السجل. ستكون القيمة دائمًا "exam". |
courses |
صفيف سلاسل | قائمة بالمعرفات الفريدة (UIds) للدورات التدريبية المقترنة. يمكن الرجوع إلى تفاصيل الدورات التدريبية في سجلات الدورات التدريبية. |
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 |
integer | متوسط الوقت الذي تستغرقه هذه الدورة التدريبية بقيادة مدرب لإكمالها بالساعات. |
url |
سلسلة | عنوان URL مؤهل بالكامل لصفحة تفاصيل الدورة التدريبية بقيادة مدرب في Microsoft Learn باللغة المحلية المطلوبة. |
icon_url |
سلسلة | عنوان URL مؤهل بالكامل لصورة SVG بحجم 100x100 تمثل إنجاز الدورة التدريبية بقيادة مدرب. |
locales |
صفيف سلاسل | قائمة باللغات التي تُقدم بها هذه الدورة التدريبية بقيادة مدرب رسميًا. قد يدعم شركاء التعلم لغات أخرى. |
type |
سلسلة | نوع السجل. ستكون القيمة دائمًا "course" للدورات التدريبية بقيادة مدرب. |
certification |
سلسلة | الشهادة المقترنة بالدورة التدريبية بقيادة مدرب. |
exam |
سلسلة | الاختبار المقترن بالدورة التدريبية بقيادة مدرب. |
levels |
صفيف سلاسل | قائمة بالمستويات المقترنة بهذه الدورة التدريبية بقيادة مدرب، والتي تشير إلى مقدار الخبرة في الدور الضروري لفهم جميع جوانب هذه الدورة التدريبية. يمكن الرجوع إلى تفاصيل الوحدات في سجلات المستويات. |
study_guide |
صفيف من الكائنات | عنوان URL مؤهل بالكامل لملف PDF يحدد المهارات التي تقيسها هذه الشهادة. |
سجلات المستوى والمنتج والدور والموضوع
توفر المجموعات levels وproducts وroles وsubjects أسماء مألوفة للقيم المستخدمة في الوحدة وبيانات مسار التعلم. كل المجموعات الأربعة لها نفس الشكل:
{
"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)
الخطوات التالية
راجع الموارد أدناه لمساعدتك في رحلة التطوير الخاصة بك: