Microsoft Learn 目錄 API 功能概觀
Microsoft Learn 類別目錄 API 是 REST 型 Web API，可讓您將 Web 型查詢傳送給 Microsoft Learn，並取得可用訓練內容和認證測驗的詳細資料，例如標題、涵蓋的產品、等級、訓練連結，以及其他中繼資料，並傳回 JSON 編碼回應與資訊。
它會傳回所有公開可用的相關資訊：
- 模組
- 單位
- 學習路徑
- 套用的技能
- 認證
- 測驗
- 導學型課程
注意
在最近的 Microsoft Learn 網站更新中，learn.microsoft.com 網域上有可用的新目錄 API 端點。 舊端點仍會如預期般運作，但切換至新端點的優點是，它會為您提供增強的功能，例如其他查詢參數。
使用案例
- 檢視 Microsoft Learn 訓練和/或認證供應項目的中繼資料
- 提取 Microsoft Learn 訓練和/或認證供應項目清單，以便從您自己的線上體驗連結至這些供應項目
Microsoft Learn 目錄 API 的運作方式
API 是 REST 型的 Web API，會傳回 JSON 編碼的回應。 若要要求完整目錄，請將 GET 要求傳送至:
https://learn.microsoft.com/api/catalog/
此輸出看起來應該類似下列螢幕擷取畫面。 至 2022 年 11 月止，完整回應約為 13 MB。
每個學習類別目錄項目都是物件，每個物件都有一組可用的中繼資料。 完整的資料字典和其他選項會列在 Microsoft Learn 目錄 API 開發人員文件 中。 我們也提供版本資訊 (連結)，以查看最新的更新，以及最佳做法資訊。
如果您想要使用它，請參閱 使用 cURL 和 Visual Studio Code 開始使用 Microsoft Learn 目錄 API 一文。
需求
存取 Microsoft Learn 目錄 API 不需要驗證。 使用者可以使用其慣用的 API 要求方法，例如 cURL、Postman 等。
範例
以下是我們看到使用者使用 Microsoft Learn 目錄 API 的許多方式其中幾個：
- Viva Learning 已使用 Learn 目錄 API 來提供 Microsoft Learn 目錄作為其核心體驗的一部分。
- 組織和教育機構使用 Microsoft Learn 目錄 API 來提取類別目錄資訊，並張貼在其內部學習管理系統 (LMS)，讓員工和學生可以輕鬆地存取它。
- 學習提供者會使用 Microsoft Learn 目錄 API 來提取目錄資訊，並張貼在其客戶學習體驗中。
可用性和價格
Microsoft Learn 目錄 API 已公開可用，並依據 Microsoft API 使用規定提供。 使用 API 不收費。
限制
- API 包含公開可用的課程模組、單元、學習路徑、導學型課程、測驗和認證。 目前不會輸出文件、程式碼範例、顯示或事件。
- API 每天至少重新整理一次。
- 更新 API 版本將會透過更新來傳達至 Microsoft Learn 目錄 API 版本資訊。
下一步
若要深入了解 Microsoft Learn 目錄 API，請檢閱下列文章：