Поделиться через

Справочная документация разработчика по API платформы Learn

В этой статье содержатся сведения для разработчиков и интеграторов, реализующих API платформы Microsoft Learn. Мы также рекомендуем ознакомиться с обзором API платформы Learn, заметками о выпуске и часто задаваемыми вопросами, чтобы поддержать ваш путь в разработке.

Конечные точки API

Конечные точки каталога API платформы Microsoft Learn — это набор веб-API на основе REST, возвращающих ответ в кодировке JSON.

Конечные точки доступны по адресу:

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

Замечание

Если вы используете другую, старую конечную точку, она по-прежнему будет работать должным образом до июня 2026 года, после чего начнется процесс устаревания старого неаутентифицированного API каталога. Если у вас есть дополнительные вопросы, обратитесь к LearnPlatformAPIMigration@microsoft.com.

Случаи использования

Authentication

ИНТЕРФЕЙСы REST API платформы Learn используют идентификатор Microsoft Entra для проверки подлинности. Перед вызовами API необходимо выбрать метод доступа, а клиентское приложение должно пройти проверку подлинности с помощью допустимых учетных данных.

Доступ только для приложений

Когда приложение обращается непосредственно к Learn, его доступ не привязан к одному пользователю. Приложение вызывает API непосредственно с помощью собственного удостоверения, этот сценарий является доступом только для приложений. Дополнительные сведения см. на платформе удостоверений Майкрософт.

Чтобы приступить к работе, вам потребуется действительная учетная запись на платформе идентификации Microsoft, которая может быть регистрацией приложения или управляемым удостоверением. В идеале каждый партнер должен иметь одно удостоверение, чтобы упростить квоту и управление партнерами. Использование управляемого удостоверения, назначаемого пользователем, может помочь объединить управляемые удостоверения между различными службами.

После настройки удостоверения Entra ID получите маркер доступа из Entra ID с областью https://learn.microsoft.com/.default, установленной в качестве подтверждения аутентификации. Включите маркер доступа в заголовок авторизации HTTP при выполнении запросов REST API в Learn.

Делегированный доступ

Когда пользователь входит в приложение и использует его для доступа к Learn, приложению сначала потребуется запросить разрешение на доступ к этому ресурсу от имени пользователя. Этот сценарий называется делегированным доступом. Дополнительные сведения см. на платформе удостоверений Майкрософт.

Чтобы приступить к работе, необходимо зарегистрировать регистрацию приложения. После настройки регистрации приложения приложение должно попросить пользователя предоставить определенную область или набор областей для доступа к Learn от имени пользователя. Узнайте больше о списке областей доступа для детального управления доступом к ресурсам. Список областей:

  • https://learn.microsoft.com/PublicContent.Read.All: Эта область действия позволяет пользователям получать доступ к общедоступному контенту в Learn от имени вошедшего в систему пользователя.

Параметры запроса

Ниже приведены параметры запроса, которые может включать запрос. Требуется только версия API, а текущая версия — 2023-11-01-preview. Необходимо закодировать значения параметров запроса в формате URL. Конечную точку можно использовать с одним, некоторыми или всеми этими параметрами.

Это важно

Если вы используете несколько фильтров, запрос оценивается с помощью оператора И (AND); значениями с разделителями-запятыми внутри фильтра объединяются по принципу ИЛИ.

Имя Ценность Тип Обязательно Example
версия API Версия API указывается в виде параметра запроса api-version и использует формат гггг-ММ-dd для стабильных версий и гггг-ММ-dd-preview для предварительных версий. Для каждого запроса API требуется параметр запроса версии API. струна Да ?api-version=2023-11-01-preview
местность Один допустимый код языкового стандарта из поддерживаемого списка языковых стандартов. Возвращенные метаданные будут находиться в запрошенном языковом стандарте, если он доступен. Если этот параметр не указан, будет возвращён ответ en-us. струна нет ?locale=en-us
id Разделенный запятыми список одного или нескольких допустимых идентификаторов содержимого (uid) из доступных типов контента. Примечание. Идентификаторы uids чувствительны к регистру. струна нет ?uid=learn.azure.intro-to-azure-fundamentals
updatedAt.gt Оператор и datetime для фильтрации по последней измененной дате объектов. Оператор включает gt (больше), gte (больше или равно). При использовании этого параметра оператор будет установлен по умолчанию на gt, если не будет указан. струна нет ?updatedAt.gt=2022-01-01
Уровней Список разделенных запятыми одного или нескольких уровней, доступных в настоящее время (полный список находится в объекте уровня ответа API). струна нет ?levels=beginner
roles Список разделенных запятыми одной или нескольких ролей, доступных в настоящее время (полный список находится в объекте ролей ответа API). струна нет ?roles=developer
products Список разделенных запятыми одной или нескольких ролей, доступных в настоящее время (полный список находится в объекте продуктов ответа API). API не поддерживает иерархию продуктов, поэтому добавьте каждый продукт в список, который вы хотите включить в запрос. струна нет ?products=azure
Предметы Список разделенных запятыми одной или нескольких ролей, доступных в настоящее время (полный список находится в объекте субъектов ответа API). API не поддерживает иерархию субъектов, поэтому добавьте каждый субъект в список, который вы хотите включить в запрос. струна нет ?subjects=cloud-computing
maxpagesize Максимальное количество ресурсов, включаемых в один ответ. Значение по умолчанию — 30. Максимально допустимое значение равно 100. струна нет ?maxpagesize=50

Ответ API

Служба может возвращать следующие коды состояния HTTP.

Код состояния Description
200 Успех. Текст ответа содержит данные в кодировке JSON.
400 Один из параметров запроса отсутствует или имеет недопустимое значение.
401 Несанкционированный запрос.
404 URL-адрес не найден на сервере.
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"
}

Сведения о свойстве

Недвижимость Тип Обязательно Description
type enum Да Тип дискриминатор. Разрешено: module.
id string Да Глобальный уникальный идентификатор модуля.
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[] Да Соответствующие классификации субъектов.
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"
},

Сведения о свойстве

Недвижимость Тип Обязательно 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"
}

Сведения о свойстве

Недвижимость Тип Обязательно Description
type enum Да Тип дискриминатор. Разрешено: learningPath.
id string Да Уникальный идентификатор для этого пути обучения в Microsoft Learn.
url uri Да Полный URL-адрес пути обучения в запрошенном языковом стандарте.
locale string Да Языковой стандарт, на котором записан путь обучения; по умолчанию возвращается en-us, если запрошенный языковой стандарт недоступен.
title string Да Локализованный заголовок учебного плана.
durationInMinutes integer Да Среднее время завершения для пути обучения в минутах.
summary string Да Краткое описание схемы обучения.
iconUrl uri Да URL-адрес значка 100×100 SVG, представляющего схему обучения.
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"
}

Сведения о свойстве

Недвижимость Тип Обязательно Description
type enum Да Тип дискриминатор. Разрешено: appliedSkills.
id string Да Уникальный идентификатор для этого используемого навыка в Microsoft Learn.
locale string Да Локаль, в которую записывается применённый навык, откатывается на en-us, если запрошенная локаль недоступна.
title string Да Локализованный заголовок примененного навыка.
summary string Да Краткое описание примененного навыка.
iconUrl uri Да URL-адрес значка 100×100 SVG, представляющего примененный навык.
url uri Да Полный URL-адрес навыка, примененного в запрошенной локали.
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"
}

Сведения о свойстве

Недвижимость Тип Обязательно Description
type enum Да Тип дискриминатор. Разрешено: certification.
id string Да Уникальный идентификатор для этой сертификации в Microsoft Learn.
locale string Да Языковой стандарт, в который записывается сертификация; возвращается обратно, en-us если запрошенный языковой стандарт недоступен.
title string Да Локализованное название сертификации.
subtitle string Да Локализованный подзаголовок сертификации.
iconUrl uri Да URL-адрес значка 100×100 SVG, представляющего сертификацию.
url uri Да Полный и корректный URL-адрес сертификации в указанной языковой локали.
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"
}

Сведения о свойстве

Недвижимость Тип Обязательно Description
type enum Да Тип дискриминатор. Разрешено: exam.
id string Да Уникальный идентификатор для этого экзамена в Microsoft Learn.
locale string Да Языковой стандарт, в который записывается экзамен; падает обратно на en-us, если запрошенный языковой стандарт недоступен.
title string Да Локализованный заголовок экзамена.
subtitle string Да Локализованный подзаголовок экзамена.
iconUrl uri Да URL-адрес значка SVG 100×100, представляющего экзамен.
url uri Да Полный URL-адрес экзамена в запрошенной языковой локали.
levels Level[] Да Уровни опыта, связанные с этим экзаменом.
roles Role[] Да Соответствующие должностные роли.
products Product[] Да Соответствующие классификации продуктов.
locales Locale[] Да Языки, в которые официально предлагается экзамен.
examNumber string Да Идентификатор номера экзамена.
pdfUrl uri нет URL-адрес PDF-файла "Измеряемые навыки" для этого экзамена.
practiceAssessmentUrl uri нет URL-адрес к бесплатной демоверсии для подготовки к этому экзамену.
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"
},

Сведения о свойстве

Недвижимость Тип Обязательно Description
type enum Да Тип дискриминатор. Разрешено: course.
id string Да Уникальный идентификатор этого курса в Microsoft Learn.
url uri Да Полный URL-адрес курса в запрошенной локализации.
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, 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"
        },
        ...
    ]
}

Дальнейшие шаги

Просмотрите приведенные ниже ресурсы, чтобы помочь вам в процессе разработки:

  • Last updated on