مشاركة عبر

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

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

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

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

يمكن الوصول إلى نقاط النهاية على:

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

‏‫ملاحظة‬

إذا كنت تستخدم نقطة نهاية مختلفة وأقدم، ستظل تعمل كما هو متوقع حتى يونيو 2026، وعندها ستبدأ واجهة برمجة التطبيقات القديمة غير المصادقة للكتالوج في الاستهلاك. إذا كان لديك المزيد من الأسئلة، تواصل مع LearnPlatformAPIMigration@microsoft.com.

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

المصادقة

تستخدم واجهات برمجة التطبيقات REST في منصة التعلم معرف Microsoft Entra للمصادقة. قبل إجراء استدعاءات API، تحتاج إلى اختيار طريقة وصول، ويجب أن يتحقق تطبيق العميل الخاص بك ببيانات اعتماد صحيحة.

الوصول إلى التطبيق فقط

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

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

بمجرد إعداد هوية Entra ID الخاصة بك، احصل على رمز وصول من Entra ID مع تعيين النطاق كدليل https://learn.microsoft.com/.default على المصادقة. أدرج رمز الوصول في رأس تفويض HTTP عند إجراء طلبات REST API للتعلم.

الوصول المفوض

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

للبدء، تحتاج إلى تسجيل تسجيل التطبيق. بمجرد إعداد تسجيل التطبيق، يحتاج تطبيقك إلى طلب منح نطاق محدد، أو مجموعة من النطاقات للوصول إلى التعلم نيابة عن المستخدم. يوفر Learn قائمة بالمواقع للوصول الدقيق إلى الموارد. تشمل قائمة النطاقات:

  • https://learn.microsoft.com/PublicContent.Read.All: يتيح هذا النطاق للمستخدمين الوصول إلى المحتوى العام على Learn وهم ينتفون بأنه المستخدم المسجل.

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

فيما يلي معلمات الاستعلام التي يمكن أن يشملها الطلب. الإصدار المطلوب فقط من نوع API والإصدار الحالي هو 2023-11-01-preview. يجب عليك ترميز قيم معلمات الاستعلام بعنوان URL. يمكنك استخدام نقطة النهاية مع واحدة أو بعض أو كل هذه المعلمات.

هام

إذا استخدمت أكثر من واحد، يتم تقييم الاستعلام باستخدام عامل AND؛ القيم المحددة بالفواصل داخل المرشح تدمج بنظام OR.

Name Value Type Required مثال
نسخة واجهة برمجة التطبيقات يتم تحديد نسخة API كمعامل استعلام إصدار API وتستخدم yyyyy-MM-dd للإصدارات المستقرة وyyyy-MM-dd-preview للإصدارات المسبقة. معامل استعلام إصدار API مطلوب لكل طلب واجهة برمجة تطبيقات (API). string نعم ?api-version=2023-11-01-preview
موقع رمز محلي واحد صالح من قائمة المواقع المدعومة. البيانات الوصفية المرتجلة ستكون في الموقع المطلوب إذا كانت متاحة. إذا لم يتم توفير هذا المعامل، سيتم إرجاع الرد en-us . string لا ?locale=en-us
معرف قائمة مفصولة بفاصل لمعرف محتوى أو أكثر صالحا (uid) من أنواع المحتوى المتاحة. ملاحظة: الواجهات المستخدمة حساسة لحرف الحروف. string لا ?uid=learn.azure.intro-to-azure-fundamentals
updatedAt.gt عامل وتاريخ للتصفية حسب آخر تاريخ معدل للأجسام. المشغل يشمل gt (أكبر من)، gte (أكبر من أو يساوي ال). عند استخدام هذا المعامل، سيقوم المشغل افتراضيا بتغيير إذا gt لم يتم تحديده. string لا ?updatedAt.gt=2022-01-01
المستويات قائمة مفصولة بفاصل لمستوى أو أكثر من المستويات المتاحة لدينا حاليا (القائمة الكاملة موجودة في كائن المستويات في استجابة API). string لا ?levels=beginner
ادوار قائمة مفصولة بفاصل لواحد أو أكثر من الأدوار المتاحة لدينا حاليا (القائمة الكاملة موجودة في كائن الأدوار في استجابة API). string لا ?roles=developer
products قائمة مفصولة بالفواصل لواحد أو أكثر من الأدوار المتاحة لدينا حاليا (القائمة الكاملة موجودة في كائن المنتجات في استجابة API). واجهة برمجة التطبيقات لا تدعم تسلسل المنتجات الهرمي، لذا أضف كل منتج إلى القائمة التي تريد تضمينها في استفسارك. string لا ?products=azure
المواد قائمة مفصولة بفاصل لواحد أو أكثر من الأدوار المتاحة لدينا حاليا (القائمة الكاملة موجودة في كائن الموضوع في استجابة API). واجهة برمجة التطبيقات لا تدعم تسلسل الموضوعات، لذا أضف كل موضوع إلى القائمة التي تريد تضمينها في استفسارك. string لا ?subjects=cloud-computing
الحد الأقصى لحجم الصفحات الحد الأقصى لعدد الموارد التي يجب تضمينها في استجابة واحدة. القيمة الافتراضية هي 30. الحد الأقصى للقيمة المسموح بها هو 100. string لا ?maxpagesize=50

استجابة API

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

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

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

هيئة الاستجابة

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

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

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

{
  "type": "module",
  "id": "learn.wwl.fundamentals-generative-ai",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/",
  "locale": "en-us",
  "title": "Introduction to generative AI and agents",
  "durationInMinutes": 37,
  "summary": "Ever wondered how AI can create content, answer questions, and assist with tasks? This module introduces you to the world of generative AI and agents.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/fundamentals-generative-ai.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "units": [
    {
      "id": "learn.wwl.fundamentals-generative-ai.introduction"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.language-models"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.writing-prompts"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.agents"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.exercise-ai-agent"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.knowledge-check"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.summary"
    }
  ],
  "updatedAt": "2025-12-23T00:20:00.0000000Z"
}

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: module.
id string نعم معرف وحدة فريد عالميا.
url uri نعم رابط مؤهل بالكامل للوحدة في الموقع المطلوب.
locale string نعم موقع محتوى الوحدات. تحدد en-us الإعدادات الافتراضية إذا لم يكن الموقع المطلوب متاحا.
title string نعم عنوان الوحدة المحلية.
durationInMinutes integer نعم متوسط وقت إكمال الوحدة بالدقائق.
summary string نعم وصف مختصر للوحدة.
iconUrl uri نعم رابط URL لأيقونة وحدة شفافة بحجم 100×100 SVG.
levels Level[] نعم مستويات الخبرة المرتبطة بهذه الوحدة.
roles Role[] نعم أدوار وظيفية ذات صلة.
products Product[] نعم تصنيفات المنتجات ذات الصلة.
subjects Subject[] نعم تصنيفات المواد ذات الصلة.
units UnitReference[] نعم وحدات التعلم المرتبطة بها.
updatedAt date-time نعم آخر تحديث لطابع الزمن (قد لا يتغير في التعديلات الطفيفة).

سجلات الوحدة

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

{ 
"type": "unit",
  "id": "learn.wwl.fundamentals-generative-ai.agents",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/7-agents/",
  "locale": "en-us",
  "title": "AI agents",
  "durationInMinutes": 5,
  "updatedAt": "2025-10-06T17:09:00.0000000Z"
},

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: unit.
id string نعم معرف فريد لهذه الوحدة عبر Microsoft Learn.
url uri نعم رابط URL مؤهل بالكامل للوحدة في الموقع المطلوب.
locale string نعم موقع الوحدة؛ يعود الأمر إلى en-us إذا كان الموقع المطلوب غير متاح.
title string نعم عنوان الوحدة المحلية (احتياطي: الإنجليزية الأمريكية).
durationInMinutes integer نعم متوسط وقت الإكمال بالدقائق.
updatedAt date-time نعم آخر تحديث زمني؛ قد يبقى دون تغيير للتعديلات البسيطة.

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

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

{
  "type": "learningPath",
  "id": "learn.introduction-ai-azure",
  "url": "https://learn.microsoft.com/training/paths/introduction-to-ai-on-azure/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "durationInMinutes": 669,
  "summary": "This course introduces core concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions, focusing on Microsoft Foundry.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/document-intelligence-knowledge-mining.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "modules": [
    {
      "id": "learn.wwl.get-started-ai-fundamentals"
    },
    {
      "id": "learn.wwl.get-started-ai-in-foundry"
    },
    {
      "id": "learn.wwl.fundamentals-machine-learning"
    },
    {
      "id": "learn.wwl.design-machine-learning-model-training-solution"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai"
    },
    {
      "id": "learn.wwl.get-started-generative-ai-azure"
    },
    {
      "id": "learn.wwl.introduction-language"
    },
    {
      "id": "learn.wwl.get-started-language-azure"
    },
    {
      "id": "learn.wwl.introduction-ai-speech"
    },
    {
      "id": "learn.wwl.recognize-synthesize-speech"
    },
    {
      "id": "learn.wwl.introduction-computer-vision"
    },
    {
      "id": "learn.wwl.get-started-computer-vision"
    },
    {
      "id": "learn.wwl.introduction-information-extraction"
    },
    {
      "id": "learn.wwl.ai-information-extraction"
    }
  ],
  "updatedAt": "2025-12-12T00:08:00.0000000Z"
}

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: learningPath.
id string نعم معرف فريد لهذا المسار التعليمي عبر Microsoft Learn.
url uri نعم رابط URL مؤهل بالكامل لمسار التعلم في الموقع المطلوب.
locale string نعم المكان الذي يكتب فيه مسار التعلم؛ يعود الأمر إلى en-us ما إذا كان الموقع المطلوب غير متاح.
title string نعم عنوان مسار التعلم المحلي.
durationInMinutes integer نعم متوسط وقت إكمال مسار التعلم بدقائق.
summary string نعم وصف مختصر لمسار التعلم.
iconUrl uri نعم رابط URL لأيقونة SVG بحجم 100×100 تمثل مسار التعلم.
levels Level[] نعم مستويات الخبرة المرتبطة بمسار التعلم.
roles Role[] نعم أدوار وظيفية ذات صلة.
products Product[] نعم تصنيفات المنتجات ذات الصلة.
subjects Subject[] نعم تصنيفات المواد ذات الصلة.
modules ModuleReference[] نعم المراجع المرتبطة بالوحدات.
updatedAt date-time نعم آخر تحديث زمني؛ قد يبقى دون تغيير للتعديلات البسيطة.

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

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

{
  "type": "appliedSkills",
  "id": "applied-skill.deploy-and-configure-azure-monitor",
  "locale": "en-us",
  "title": "Microsoft Applied Skills: 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",
  "iconUrl": "https://learn.microsoft.com/",
  "url": "https://learn.microsoft.com/credentials/applied-skills/deploy-and-configure-azure-monitor/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "administrator",
      "name": "Administrator"
    }
  ],
  "products": [
    {
      "id": "azure-monitor",
      "name": "Azure Monitor"
    },
    {
      "id": "azure-virtual-machines",
      "name": "Azure Virtual Machines"
    },
    {
      "id": "azure-virtual-network",
      "name": "Azure Virtual Network"
    },
    {
      "id": "windows-server",
      "name": "Windows Server"
    }
  ],
  "subjects": [
    {
      "id": "it-management-monitoring",
      "name": "IT management and monitoring"
    }
  ],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: appliedSkills.
id string نعم معرف فريد لهذه المهارة المطبقة عبر Microsoft Learn.
locale string نعم المكان الذي تكتب فيه المهارة التطبيقية؛ يعود الأمر إلى en-us إذا كان الموقع المطلوب غير متاح.
title string نعم عنوان مهارة تطبيقية محلية.
summary string نعم وصف موجز للمهارة المطبقة.
iconUrl uri نعم رابط URL لأيقونة SVG بحجم 100×100 تمثل المهارة المطبقة.
url uri نعم رابط مؤهل بالكامل للمهارة التطبيقية في الموقع المطلوب.
levels Level[] نعم مستويات الخبرة المرتبطة بهذه المهارة المطبقة.
roles Role[] نعم أدوار وظيفية ذات صلة.
products Product[] نعم تصنيفات المنتجات ذات الصلة.
subjects Subject[] نعم تصنيفات المواد ذات الصلة.
updatedAt date-time نعم آخر تحديث زمني؛ قد يبقى دون تغيير في حال التحديثات الطفيفة.

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

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

{
  "type": "certification",
  "id": "certification.d365-functional-consultant-customer-service",
  "locale": "en-us",
  "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate (Legacy with Power Platform)",
  "subtitle": "<p>If you’re a functional consultant responsible for configuring and implementing Dynamics 365 solutions for customers, you can use this certification to shine a light on your skills and to help advance your career. A Dynamics 365 Customer Service functional consultant implements omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction. As a functional consultant, you know how to work with project managers, developers, and solution architects. You need a minimum of one to three years of experience as a functional consultant implementing Dynamics 365.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Work as a Dynamics 365 functional consultant on one or more projects.</li>\n<li>Work on a Dynamics 365 Customer Service implementation.</li>\n<li>Join the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>.</li>\n<li>Take available learning paths on <a href=\"/training/browse/?expanded=dynamics-365&amp;products=dynamics-customer-service&amp;roles=functional-consultant&amp;resource_type=learning%20path\">Microsoft Learn</a>.</li>\n<li>Complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course.</li>\n</ul>\n<div class=\"WARNING\">\n<p>Warning</p>\n<p>This version of the certification is no longer available. <a href=\"https://techcommunity.microsoft.com/t5/microsoft-learn-blog/new-exam-structure-for-dynamics-365-certifications-for-customer/ba-p/3500861\">Read this blog post for more information about this change</a>.</p>\n</div>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/d365-functional-consultant-customer-service-legacy-with-power-platform/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-analyst",
      "name": "Business Analyst"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "functional-consultant",
      "name": "Functional Consultant"
    }
  ],
  "products": [
    {
      "id": "power-apps",
      "name": "Power Apps"
    },
    {
      "id": "power-bi",
      "name": "Power BI"
    },
    {
      "id": "power-automate",
      "name": "Power Automate"
    },
    {
      "id": "dataverse",
      "name": "Microsoft Dataverse"
    },
    {
      "id": "ai-builder",
      "name": "AI Builder"
    },
    {
      "id": "power-platform",
      "name": "Microsoft Power Platform"
    },
    {
      "id": "office-teams",
      "name": "Microsoft Teams"
    },
    {
      "id": "microsoft-copilot-studio",
      "name": "Microsoft Copilot Studio"
    },
    {
      "id": "dynamics-365",
      "name": "Dynamics 365"
    },
    {
      "id": "dynamics-customer-service",
      "name": "Customer Service"
    }
  ],
  "subjects": [],
  "certificationType": {
    "id": "role-based",
    "name": "role-based"
  },
  "renewalFrequencyInDays": 0,
  "prerequisites": [],
  "exams": [
    {
      "id": "exam.mb-230"
    }
  ],
  "updatedAt": "2024-10-08T15:40:00.0000000Z"
}

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: certification.
id string نعم معرف فريد لهذه الشهادة عبر Microsoft Learn.
locale string نعم المكان الذي تكتب فيه الشهادة؛ يعود الأمر إلى en-us ما إذا كان الموقع المطلوب غير متاح.
title string نعم عنوان شهادة محلي.
subtitle string نعم عنوان شهادة محلي.
iconUrl uri نعم رابط URL لأيقونة SVG 100×100 تمثل الشهادة.
url uri نعم رابط مؤهل بالكامل للشهادة في الموقع المطلوب.
levels Level[] نعم مستويات الخبرة المرتبطة بهذه الشهادة.
roles Role[] نعم أدوار وظيفية ذات صلة.
products Product[] نعم تصنيفات المنتجات ذات الصلة.
subjects Subject[] نعم تصنيفات المواد ذات الصلة.
certificationType Taxonomy نعم تصنيف يمثل نوع الشهادة.
renewalFrequencyInDays integer نعم عدد الأيام قبل انتهاء هذه الشهادة؛ 0 يعني أنه لا ينتهي صلاحيته.
prerequisites string[] نعم قائمة بالمتطلبات الموصى بها للحصول على هذه الشهادة.
exams ExamReference[] نعم الامتحانات المرتبطة المطلوبة لهذه الشهادة.
updatedAt date-time نعم الطابع الزمني لآخر تحديث؛ قد يبقى دون تغيير للتعديلات البسيطة.

سجلات الامتحانات

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

{
  "type": "exam",
  "id": "exam.77-881",
  "locale": "en-us",
  "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.",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/exams/77-881/",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-user",
      "name": "Business User"
    }
  ],
  "products": [
    {
      "id": "office-word",
      "name": "Word"
    }
  ],
  "locales": [],
  "examNumber": "77-881",
  "pdfUrl": "https://learn.microsoft.comhttps//query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
  "practiceAssessmentUrl": "https://learn.microsoft.com/",
  "providers": [],
  "courses": [],
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: exam.
id string نعم معرف فريد لهذا الاختبار عبر Microsoft Learn.
locale string نعم المكان الذي يكتب فيه الامتحان؛ يعود الأمر إلى en-us إذا كان الموقع المطلوب غير متاح.
title string نعم عنوان الامتحان المحلي.
subtitle string نعم عنوان فرعي للامتحان المحلي.
iconUrl uri نعم رابط URL لأيقونة SVG 100×100 تمثل الامتحان.
url uri نعم رابط الاختبار مؤهل بالكامل في الموقع المطلوب.
levels Level[] نعم مستويات الخبرة المرتبطة بهذا الامتحان.
roles Role[] نعم أدوار وظيفية ذات صلة.
products Product[] نعم تصنيفات المنتجات ذات الصلة.
locales Locale[] نعم اللغات التي يقدم بها الامتحان رسميا.
examNumber string نعم معرف رقم الامتحان.
pdfUrl uri لا رابط ملف PDF "المهارات المقاسة" لهذا الاختبار.
practiceAssessmentUrl uri لا رابط لتقييم تجريبي مجاني لهذا الامتحان.
providers Provider[] لا مقدمو الخدمات الذين يقدمون هذا الفحص.
courses Course[] لا دورات يقودها المدرس مرتبطة بهذا الامتحان.
studyGuide StudyGuideRef[] لا محتوى دليل الدراسة المرتبط (المراجع متعددة الأشكال).
updatedAt date-time نعم آخر تحديث زمني؛ قد يبقى دون تغيير للتعديلات البسيطة.

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

سيكون لكل سجل مقرر الشكل التالي:

{
  "type": "course",
  "id": "course.ai-900t00",
  "url": "https://learn.microsoft.com/training/courses/ai-900t00/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "summary": "<p>This course introduces fundamentals concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions. The course is not designed to teach students to become professional data scientists or software developers, but rather to build awareness of common AI workloads and the ability to identify Azure services to support them. The course is designed as a blended learning experience that combines instructor-led training with online materials on the Microsoft Learn platform (<a href=\"https://azure.com/learn\">https://azure.com/learn</a>). The hands-on exercises in the course are based on Learn modules, and students are encouraged to use the content on Learn as reference materials to reinforce what they learn in the class and to explore topics in more depth.</p>\n<h4 id=\"audience-profile\">Audience Profile</h4>\n<p>The Introduction to AI in Azure course is designed for anyone interested in learning about the types of solution artificial intelligence (AI) makes possible, and the services on Microsoft Azure that you can use to create them. You don’t need to have any experience of using Microsoft Azure before taking this course, but a basic level of familiarity with computer technology and the Internet is assumed. Some of the concepts covered in the course require a basic understanding of mathematics, such as the ability to interpret charts. The course includes hands-on activities that involve working with data and running code, so a knowledge of fundamental programming principles will be helpful.</p>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/course.svg",
  "courseNumber": "AI-900T00",
  "durationInHours": 24,
  "locales": [
    {
      "id": "en",
      "name": "en"
    },
    {
      "id": "ar",
      "name": "ar"
    },
    {
      "id": "zh-cn",
      "name": "zh-cn"
    },
    {
      "id": "zh-tw",
      "name": "zh-tw"
    },
    {
      "id": "fr",
      "name": "fr"
    },
    {
      "id": "de",
      "name": "de"
    },
    {
      "id": "id",
      "name": "id"
    },
    {
      "id": "it",
      "name": "it"
    },
    {
      "id": "ja",
      "name": "ja"
    },
    {
      "id": "ko",
      "name": "ko"
    },
    {
      "id": "pt-br",
      "name": "pt-br"
    },
    {
      "id": "ru",
      "name": "ru"
    },
    {
      "id": "es",
      "name": "es"
    }
  ],
  "levels": [],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    }
  ],
  "products": [
    {
      "id": "azure",
      "name": "Azure"
    }
  ],
  "certification": {
    "id": "certification.azure-ai-fundamentals"
  },
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
},

تفاصيل الخاصية

الخاصية Type Required Description
type enum نعم مميز النوع. مسموح به: course.
id string نعم معرف فريد لهذه الدورة عبر Microsoft Learn.
url uri نعم رابط المسار مؤهل بالكامل في الموقع المطلوب.
locale string نعم الموقع الذي يكتب فيه الدورة؛ يعود الأمر إلى en-us إذا كان الموقع المطلوب غير متاح.
title string نعم عنوان الدورة المحلية.
summary string نعم وصف مختصر للمسار.
iconUrl uri نعم رابط URL لأيقونة SVG بحجم 100×100 تمثل المسار.
courseNumber string نعم رقم الدورة بقيادة المدرب.
durationInHours integer نعم متوسط الوقت لإكمال الدورة (بالساعات).
locales Locale[] نعم اللغات التي تقدم بها الدورة رسميا؛ قد يدعم الشركاء لغات أخرى.
levels Level[] نعم مستويات الخبرة المرتبطة بهذه الدورة.
roles Role[] نعم أدوار وظيفية ذات صلة.
products Product[] نعم تصنيفات المنتجات ذات الصلة.
exam ExamRef لا امتحان مرتبط بهذه الدورة.
certification CertRef لا شهادة مرتبطة بهذه الدورة.
studyGuide StudyGuideRef[] لا مواد دراسية ذات صلة (مراجع متعددة الأشكال).
updatedAt date-time نعم آخر تحديث زمني؛ قد يبقى دون تغيير في حال التحديثات الطفيفة.

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

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

{ 
    "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"
        },
        ...
    ]
}

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

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

  • Last updated on