Microsoft Learn 目錄 API 功能概觀
Microsoft Learn 類別目錄 API 是 REST 型 Web API,可讓您將 Web 型查詢傳送給 Microsoft Learn,並取得可用訓練內容和認證測驗的詳細資料,例如標題、涵蓋的產品、等級、訓練連結,以及其他中繼資料,並傳回 JSON 編碼回應與資訊。
它會傳回所有公開可用的相關資訊:
- 模組
- 單位
- 學習路徑
- 套用的技能
- 認證
- 測驗
- 導學型課程
注意
在最近的 Microsoft Learn 網站更新中,learn.microsoft.com 網域上有可用的新目錄 API 端點。 舊端點仍會如預期般運作,但切換至新端點的優點是,它會為您提供增強的功能,例如其他查詢參數。
- 檢視 Microsoft Learn 訓練和/或認證供應項目的中繼資料
- 提取 Microsoft Learn 訓練和/或認證供應項目清單,以便從您自己的線上體驗連結至這些供應項目
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,請檢閱下列文章: