Microsoft Learn 目錄 API 開發人員參考文件

發行項
10/31/2023

本文提供實作 Microsoft Learn 目錄 API 的開發人員和要求者的資訊。我們也建議您參閱 Learn 目錄 API 最佳做法、版本資訊和常見問題集文章，以支援您的開發旅程。

API 端點

Microsoft Learn 目錄 API 是以 REST 為基礎的 Web API，會傳回 JSON 編碼的回應。若要要求完整目錄，請將 GET 要求傳送至:

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

注意

上面所列的端點是目前的端點。如果您使用不同的較舊端點，當您上線時，它仍可如預期般運作，但切換至新端點的優點是它能為您提供增強的功能，例如其他查詢參數。

查詢參數

以下是要求可以包含的查詢參數。全部都是選擇性。您必須為查詢參數值進行 URL 編碼。您可以使用端點搭配無、一個、部分或所有這些參數。

重要

如果您使用多個查詢，將會使用 AND 運算子來評估查詢。

名稱	值	類型	必要	範例
地區設定	支援的地區設定清單的單一有效地區設定程式碼。傳回的中繼資料將會在要求的地區設定中 (如果有的話)。如果未提供此參數，會傳回 `en-us` 回應。	string	No	`?locale=en-us`
type	我們目前在回應中提供的一或多個最上層內容或分類物件的逗號分隔清單。支援的值包括：`modules`、`units`、`learningPaths`、`appliedSkills`、`certifications`、`mergedCertifications`、`exams`、`courses`、`levels`、`roles`、`products`、`subjects`。	string	No	`?type=modules,learningPaths`
uid	可用內容類型中一或多個有效內容唯一識別碼的逗號分隔清單。注意: Uid 會區分大小寫。	string	No	`?uid=learn.azure.intro-to-azure-fundamentals`
last_modified	依物件上次修改日期篩選的運算子和日期時間。運算子包括 `lt` (少於)，`lte` (少於或等於)，`eq` (等於)，`gt` (大於)，`gte` (大於或等於)。當您使用此參數時，如果未指定，運算子會預設為 `gte`。	string	No	`?last_modified=gte 2022-01-01`
熱門程度	依物件 (以 0-1 為範圍) 的熱門值篩選的運算子和值。運算子包括 `lt` (少於)，`lte` (少於或等於)，`eq` (等於)，`gt` (大於)，`gte` (大於或等於)。當您使用此參數時，如果未指定，運算子會預設為 `gte`。	string	No	`?popularity=gte 0.5`
level	我們目前有一或多個層級的逗號分隔清單 (完整清單位於 API 回應的層級物件中)。	string	No	`?level=beginner`
角色 (role)	我們目前有一或多個角色的逗號分隔清單 (完整清單位於 API 回應的角色物件中)。	string	No	`?role=developer`
product	我們目前有一或多個角色的逗號分隔清單 (完整清單位於 API 回應的產品物件中)。 API 不支援產品階層，因此請將每個產品新增至您想要包含在查詢中的清單。	string	No	`?product=azure`
主旨	我們目前有一或多個角色的逗號分隔清單 (完整清單位於 API 回應的主體物件中)。 API 不支援主體階層，因此請將每個主體新增至您想要包含在查詢中的清單。	string	No	`?subject=cloud-computing`

範例查詢

下列查詢是範例，可協助您瞭解您可以要求的內容，以及如何形成要求。

描述	查詢
Learn 目錄 API 中的所有項目	`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`

API 回應

服務可能會傳回下列 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`	string	提供課程模組簡短描述的字串。此值會以 HTML 段落標記方式表示，內部文字則為摘要。
`levels`	字串陣列	與本課程模組相關聯的層級清單，指出瞭解本課程模組所有層面所需的角色體驗。有關單元的詳細資料可以在層級記錄中參考。
`roles`	字串陣列	此課程模組相關的作業角色清單。
`products`	字串陣列	此課程模組涵蓋的相關產品清單。有關產品的詳細資料可以在產品記錄中參考。
`subjects`	字串陣列	此學習路徑涵蓋的相關主題清單。
`uid`	string	此課程模組的唯一識別碼，這個值在所有 MS Learn 中都不會重複。
`type`	string	記錄的類型。此值將一律為 'module'。
`title`	string	所要求之地區設定中的課程模組標題，或以美式英文作為後援。
`duration_in_minutes`	整數	完成此課程模組所需的平均時間 (以分鐘為單位)。
`rating`	object	包含這兩個 `count`，這是已評等課程模組的人數，和 `average`，評等匯總，為 1-5
`popularity`	double	介於 0-1 的標準化數值，表示課程模組的熱門程度
`icon_url`	string	100x100 SVG 影像的完整合格 URL，代表具有透明背景的課程模組成就影像。
`social_image_url`	string	PNG 影像的完整合格 URL，代表具有矩形不透明背景的課程模組成就影像，適用于社交媒體或磚體驗。如果此課程模組無法使用此屬性，則不會在回應中傳回此屬性。
`locale`	string	撰寫此 JSON 資料的語言。此值將會是要求的地區設定 (若可用)，否則將為 'en-us'。
`last_modified`	date	此課程模組上次有大幅修訂時間。
`url`	string	所要求地區設定中 Learn 課程模組的完整合格 URL。
`firstUnitUrl`	string	所要求地區設定中 Learn 課程模組第一個單元的完整合格 URL。
`units`	字串陣列	相關聯單元 UID 的清單。有關單元的詳細資料可以在單元記錄中參考。
`number_of_children`	整數	此課程模組中的頁面數目 (單元)。

單元記錄

每個單元記錄都會有下列形式:

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

注意

單元記錄沒有相關聯的 URL，因為單元不會寫入為獨立內容。單元應按照課程模組的特定順序進行。基於這個理由，我們會在課程模組記錄中包含課程模組詳細資料頁面和第一個單元的連結，以便使用者從該處開始並照順序進行內容。不過，單元記錄可用來取得單元的詳細資料，以在 LMSes 或其他體驗中顯示。

欄位詳細資料

欄位	類型	描述
`uid`	string	此課程模組的唯一識別碼，這個值在所有 MS Learn 中都不會重複。
`type`	string	記錄的類型。該值一律為 [unit]。
`title`	string	所要求地區設定中單元的標題，或以美式英文作為備用語言。
`duration_in_minutes`	單元的持續時間。如果您新增與每個課程模組相關聯之單元的所有duration_in_minutes，您將獲得課程模組總時間。
`locale`	string	撰寫此 JSON 資料的語言。此值將會是要求的地區設定 (若可用)，否則將為 'en-us'。
`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`	string	提供學習路徑簡短描述的字串。此值會以 HTML 段落標記方式表示，內部文字則為摘要。
`levels`	字串陣列	與本學習路徑相關聯的層級清單，指出瞭解本學習路徑所有層面所需的角色體驗。有關單元的詳細資料可以在層級記錄中參考。
`roles`	字串陣列	此學習路徑的相關作業角色清單。
`products`	字串陣列	此學習路徑涵蓋的相關產品清單。有關產品的詳細資料可以在產品記錄中參考。
`subjects`	字串陣列	此學習路徑涵蓋的相關主題清單。
`uid`	string	此學習路徑的唯一識別碼，這個值在所有 MS Learn 中都是唯一的。
`type`	string	記錄的類型。此值將一律為 'learningPath'。
`title`	string	所要求之地區設定中的學習路徑標題，或以美式英文作為後援。
`duration_in_minutes`	整數	完成此學習路徑所需的平均時間 (以分鐘為單位)。此值是所包含之所有模組的資料總和。
`rating`	object	包含這兩個 `count`，這是已評等學習路徑的人數，和 `average`，評等匯總，為 1-5
`popularity`	double	介於 0-1 的標準化數值，表示學習路徑的熱門程度
`icon_url`	string	代表學習路徑的 100x100 SVG 影像的完整合格 URL。
`social_image_url`	string	PNG 影像的完整合格 URL，代表具有矩形不透明背景的學習路徑成就影像，適用于社交媒體或磚體驗。如果此課程模組無法使用此屬性，則不會在回應中傳回此屬性。
`locale`	string	撰寫此 JSON 資料的語言。此值將會是要求的地區設定 (若可用)，否則將為 'en-us'。
`last_modified`	date	此學習路徑的上次變更時間。
`url`	string	要求的地區設定中 Microsoft Learn 學習路徑的完整 URL。
`firstModuleUrl`	string	在要求的地區設定中，Microsoft Learn 學習路徑第一個課程模組的完整 URL。
`modules`	字串陣列	相關聯的課程模組 UID 清單。課程模組記錄中可以參考課程模組的詳細資料。
`number_of_children`	整數	此學習路徑中包含的課程模組數目。

應用技能記錄

每個應用技能記錄都將採用下列形式：

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

欄位詳細資料

欄位	類型	描述
`uid`	string	此應用技能的唯一識別碼 - 此值在所有 MS Learn 中都是唯一的。
`locale`	string	撰寫此 JSON 資料的語言。此值將會是要求的地區設定 (若可用)，否則將為 'en-us'。
`title`	string	應用技能的標題 (採用要求的地區設定，或以美式英文作為備用語言)。
`summary`	string	應用技能的摘要 (採用要求的地區設定，或以美式英文作為備用語言)。
`url`	string	應用技能在 Microsoft Learn 中的完整 URL (採用要求的地區設定)。
`icon_url`	string	代表應用技能的 100x100 SVG 影像的完整 URL (適用時才提供)。
`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`	string	此認證的唯一識別碼 - 此值在所有 MS Learn 中都是唯一的。
`title`	string	所要求地區設定中認證的標題，或以美式英文作為備用語言。
`summary`	string	認證的摘要 (採用要求的地區設定，或以美式英文作為備用語言)。
`url`	string	在要求的地區設定中，Microsoft Learn 中認證的完整合格 URL。
`icon_url`	string	代表認證的 100x100 SVG 影像的完整合格 URL。
`last_modified`	date	此認證上次變更的時間。
`type`	string	記錄的類型。該值一律為 [cert]。
`certification_type`	string	認證類型。可能的值為 'fundamentals'、'mce'、'mcsa'、'mcsd'、'mcse'、'mos'、'mta'、'role-based'、'specialty'。
`products`	字串陣列	此認證涵蓋的相關產品清單。有關產品的詳細資料可以在產品記錄中參考。
`levels`	字串陣列	與本認證相關聯的層級清單，指出瞭解本認證測驗所有層面所需的角色體驗。有關單元的詳細資料可以在層級記錄中參考。
`roles`	字串陣列	此認證的相關作業角色清單。角色記錄中可以參考角色的詳細資料。
`subjects`	字串陣列	此認證涵蓋的相關主題清單。
`renewal_frequency_in_days`	整數	距離此認證到期且需要更新的天數。如果值為 0，則認證不會過期。
`prerequisites`	字串陣列	獲得此認證的建議必要條件清單。關於認證的詳細資料可在認證記錄中參考。
`skills`	字串陣列	透過此認證所需的測驗來測量的技能清單。
`recommendation_list`	字串陣列	與此認證相關的建議清單。
`study_guide`	物件陣列	要研究此認證的相關內容清單。物件的詳細資料可以在其相關聯的記錄中參考。
`exam_duration_in_minutes`	整數	分配給考生完成測驗的分鐘數。
`locales`	字串陣列	此認證採用的語言清單。
`providers`	物件陣列	此認證的提供者清單。此類型描述哪一個提供者和完整合格 URL 具有可與提供者排程測驗的連結。
`career_paths`	物件陣列	此認證的職涯路徑清單。

注意

只需要一項測驗的認證將會在此 mergedCertifications 屬性中傳回。

認證記錄

每個認證記錄都會有下列形式:

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

欄位詳細資料

欄位	類型	描述
`uid`	string	此認證的唯一識別碼 - 此值在所有 MS Learn 中都是唯一的。
`title`	string	所要求地區設定中認證的標題，或以美式英文作為備用語言。
`subtitle`	string	所要求地區設定中認證的字幕，或以美式英文作為備用語言。
`url`	string	在要求的地區設定中，Microsoft Learn 中認證的完整合格 URL。
`icon_url`	string	代表認證的 100x100 SVG 影像的完整合格 URL。
`type`	string	記錄的類型。該值一律為 [cert]。
`certification_type`	string	認證類型。可能的值為 '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&amp;utm_medium=certpage&amp;utm_campaign=msofficialpractice",
    "practice_assessment_url": "https://learn.microsoft.com/en-us/certifications/exams/{exam}/practice/assessment?assessment-type=practice&assessmentId={assessmentId}",
    "locales": [],
    "type": "exam",
    "courses": [
        "course.pl-200t00",
        "course.mb-230t01"
    ],
    "levels": [
        "beginner"
    ],
    "roles": [
        "business-user"
    ],
    "products": [
        "office-word"
    ],
    "providers": [],
    "study_guide": [
        {
            "uid": "learn.get-started-with-word-2010",
            "type": "module"
        },
        {
            "uid": "learn.office2010-notebook",
            "type": "module"
        },
        {
            "uid": "learn.office2010-fundamentals",
            "type": "learningPath"
        }
    ]
}

欄位詳細資料

欄位	類型	描述
`uid`	string	此測驗的唯一識別碼 - 此值在所有 MS Learn 中都是唯一的。
`title`	string	所要求地區設定中測驗的標題，或以美式英文作為備用語言。
`subtitle`	string	所要求地區設定中測驗的字幕，或以美式英文作為備用語言。
`display_name`	string	所要求地區設定中測驗的顯示名稱，或以美式英文作為備用語言。
`url`	string	在要求的地區設定中，Microsoft Learn 中測驗的完整合格 URL。
`icon_url`	string	代表測驗的 100x100 SVG 影像的完整合格 URL。
`pdf_download_url`	string	PDF 的完整合格 URL，概述此測驗所測量的技能。
`practice_test_url`	string	與測驗相關聯的練習測試的完整合格 URL。
`practice_assessment_url`	string	與測驗相關聯的免費練習評量的完整合格 URL。
`locales`	字串陣列	此測驗提供的語言清單。
`type`	string	記錄的類型。該值一律為 [exam]。
`courses`	字串陣列	相關聯的課程 UID 清單。課程記錄中可以參考課程的詳細資料。
`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`	string	此導學型課程的唯一識別碼 - 此值在所有 MS Learn 中都是唯一的。
`course_number`	string	導學型課程編號識別碼。
`title`	string	所要求地區設定中導學型課程的標題，或以美式英文作為備用語言。
`summary`	string	提供導學型簡短描述的字串。此值會以 HTML 段落標記方式表示，內部文字則為摘要。
`duration_in_hours`	整數	此導學型課程完成所需的平均時間 (以小時計)。
`url`	string	在要求的地區設定中，Microsoft Learn 中導學型課程的完整合格 URL。
`icon_url`	string	代表導學型課程成就的 100x100 SVG 影像的完整合格 URL。
`locales`	字串陣列	此導學型課程正式提供的語言清單。學習夥伴可能會支援其他語言。
`type`	string	記錄的類型。值一律為導學型課程的 [course]。
`certification`	string	與導學型課程相關聯的認證。
`exam`	string	與導學型課程相關聯的測驗。
`levels`	字串陣列	與本導學型課程相關聯的層級清單，指出瞭解本課程所有層面所需的角色體驗。有關單元的詳細資料可以在層級記錄中參考。
`study_guide`	物件陣列	PDF 的完整合格 URL，概述此認證所測量的技能。

層級、產品、角色和主體記錄

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 目錄 API，但以下程式碼範例是它使用方式的範例。

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);
}

使用 cURL 擴充功能的 PHP

<?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)

下一步

檢閱下列資源，以協助您在開發旅程中前進:

共用方式為

Microsoft Learn 目錄 API 開發人員參考文件

API 端點

查詢參數

範例查詢

API 回應

回應本文

課程模組記錄

欄位詳細資料

單元記錄

欄位詳細資料

學習記錄

欄位詳細資料

應用技能記錄

欄位詳細資料

合併的認證記錄

欄位詳細資料

認證記錄

欄位詳細資料

測驗記錄

欄位詳細資料

導學型課程記錄

欄位詳細資料

層級、產品、角色和主體記錄

程式碼範例

jQuery

.NET 和 C#

使用 cURL 擴充功能的 PHP

使用「要求」程式庫的 PYTHON 3

下一步

其他資源