Learn Platform API 开发人员参考文档

本文为实现 Microsoft Learn 平台 API 的开发人员和集成商提供信息。我们还建议查看 Learn 平台 API 概述、发行说明和常见问题解答文章，以支持你的开发旅程。

API 终结点

Microsoft Learn 平台 API 目录终结点是一组基于 REST 的经过身份验证的 Web API，用于返回 JSON 编码的响应。

可在以下位置访问终结点：

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

注释

如果使用其他较旧的终结点，它仍将按预期工作，直到 2026 年 6 月，此时较旧的未经身份验证的目录 API 将开始弃用。如果你有进一步的问题，请联系 LearnPlatformAPIMigration@microsoft.com。

用例

Authentication

Learn 平台 REST API 使用 Microsoft Entra ID 进行身份验证。在进行 API 调用之前，需要选择访问方法，客户端应用程序必须使用有效的凭据进行身份验证。

仅限应用访问

当应用直接访问 Learn 时，其访问权限不会绑定到任何单个用户。应用直接使用自己的标识调用 API，此方案是仅限应用的访问。详细了解 Microsoft标识平台。

若要开始，需要在 Microsoft 标识平台上提供有效的标识，该标识可以是应用注册或托管标识。理想情况下，每个合作伙伴都应具有单个标识来简化配额和合作伙伴管理。使用用户分配的托管标识可帮助跨不同服务统一托管标识。

设置好 Entra ID 标识后，从 Entra ID 获取访问令牌，并将范围设置为 https://learn.microsoft.com/.default 作为身份验证证明。在向 Learn 发出 REST API 请求时，在 HTTP 授权标头中包含访问令牌。

委派访问权限

当用户登录到你的应用并使用它来访问 Learn 时，应用首先需要请求权限才能代表用户访问此资源。此方案称为委派访问。详细了解 Microsoft标识平台。

若要开始，需要注册应用注册。完成应用注册后，你的应用需要请求用户授予特定范围（或一组范围），以代表用户访问 Learn。 Learn 提供一个用于细粒度资源访问的范围列表。范围列表包括：

https://learn.microsoft.com/PublicContent.Read.All：此范围允许用户以登录用户身份模拟访问 Learn 上的公共内容。

查询参数

以下是请求可以包括的查询参数。仅需要 API 版本，当前版本为 2023-11-01-preview。必须对查询参数值进行 URL 编码。可以将终结点与一个、部分或所有这些参数一起使用。

重要

如果使用多个查询，则使用 AND 运算符评估查询;筛选器内的逗号分隔值是 OR 组合的。

Name	价值	类型	必选	Example
api-version	API 版本指定为 api 版本查询参数，将 yyyy-MM-dd 用于稳定版本，将 yyyy-MM-dd-preview 用于预览版本。每个 API 请求都需要 API 版本查询参数。	字符串	是的	`?api-version=2023-11-01-preview`
区域设置	从支持的区域设置列表中选出的单个有效区域设置代码。如果可用，返回的元数据将位于请求的区域设置中。如果未提供此参数， `en-us` 将返回响应。	字符串	否	`?locale=en-us`
id	可用内容类型的一个或多个有效内容惟一 ID (uid) 的逗号分隔列表。注意：uid 区分大小写。	字符串	否	`?uid=learn.azure.intro-to-azure-fundamentals`
updatedAt.gt	一个运算符和日期时间，用于按对象的上次修改日期进行筛选。运算符包括 `gt` （大于）、 `gte` （大于或等于）。使用此参数时，如果未指定，运算符将默认为 `gt`。	字符串	否	`?updatedAt.gt=2022-01-01`
等级	我们当前可用的一个或多个级别的逗号分隔列表（完整列表位于 API 响应的 level 对象中）。	字符串	否	`?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`	是的	指向 100×100 SVG 透明模块图标的 URL。
`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`	是的	表示学习路径的 100×100 SVG 图标的 URL。
`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`	是的	表示应用技能的 100×100 SVG 图标的 URL。
`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`	是的	表示认证的 100×100 SVG 图标的 URL。
`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`	是的	代表该考试的 100x100 SVG 图标 URL。
`url`	`uri`	是的	请求区域设置中考试的完整 URL。
`levels`	`Level[]`	是的	与此考试关联的经验水平。
`roles`	`Role[]`	是的	相关的作业角色。
`products`	`Product[]`	是的	相关的产品分类。
`locales`	`Locale[]`	是的	考试正式提供的语言。
`examNumber`	`string`	是的	考试编号标识符。
`pdfUrl`	`uri`	否	此考试“技能测评内容”PDF的URL。
`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`	是的	代表该课程的 100x100 SVG 图标 URL。
`courseNumber`	`string`	是的	讲师主导的课程编号。
`durationInHours`	`integer`	是的	完成课程的平均时间（以小时为单位）。
`locales`	`Locale[]`	是的	课程正式提供的语言：合作伙伴可能支持其他语言。
`levels`	`Level[]`	是的	与本课程关联的经验级别。
`roles`	`Role[]`	是的	相关的作业角色。
`products`	`Product[]`	是的	相关的产品分类。
`exam`	`ExamRef`	否	本课程的相关考试。
`certification`	`CertRef`	否	本课程的相关认证。
`studyGuide`	`StudyGuideRef[]`	否	相关研究材料（多态参考）。
`updatedAt`	`date-time`	是的	上次更新的时间戳;对于次要更新，可能保持不变。

级别、产品、角色和主题记录

和levelsproductsrolessubjects集合为模块和学习路径数据中使用的值提供友好名称。所有四个集合具有相同的形状：

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

id 将与其他目录条目中包含的级别、产品、角色和主题的值匹配。关联的 name 为条目提供了适当的英文名称。该 children 数组是可选的，可为具有子关系（如产品）的值启用分层。

例如，下面是一组可能的角色：

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

下面是一组产品示例，其中包含了提供更具体产品类别的子产品。

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

后续步骤

查看以下资源，帮助你完成开发旅程：

Last updated on 2026-02-12

通过

Learn Platform API 开发人员参考文档

API 终结点

用例

Authentication

仅限应用访问

委派访问权限

查询参数

API 响应

响应正文

模块响应

属性详细信息

单位记录

属性详细信息

学习路径记录

属性详细信息

应用技能记录

属性详细信息

认证记录

属性详细信息

考试记录

属性详细信息

由讲师主导的课程记录

属性详细信息

级别、产品、角色和主题记录

后续步骤

其他资源