Chia sẻ qua


Tổng quan về tính năng API Danh mục của Microsoft Learn

API Danh mục Microsoft Learn là MỘT API Web dựa trên REST cho phép bạn gửi truy vấn dựa trên web đến Microsoft Learn và nhận lại chi tiết về nội dung đào tạo và kỳ thi chứng nhận có sẵn như tiêu đề, sản phẩm được đề cập, cấp độ, liên kết đến đào tạo và siêu dữ liệu khác và trả về phản hồi được mã hóa JSON cùng với thông tin.

Nó trả về thông tin về tất cả công khai có sẵn:

  • Module
  • Đơn vị
  • Lộ trình học tập
  • Kỹ năng ứng dụng
  • Chứng nhận
  • Thi
  • Instructor-Led khóa học

Ghi

Một bộ điểm cuối API mới để truy cập Dữ liệu Danh mục Microsoft Learn, thay thế API Danh mục Tìm hiểu, hiện đã có sẵn. Điểm cuối hiện tại được ghi lại ở đây sẽ tiếp tục hoạt động cho đến tháng 6 năm 2026, nhưng nó được lên kế hoạch ngừng sử dụng. Chúng tôi khuyên bạn nên di chuyển sang các điểm cuối mới trên API Nền tảng Microsoft Learn để tận dụng các tính năng nâng cao, bao gồm các tham số truy vấn bổ sung.

Trường hợp sử dụng

  • Xem siêu dữ liệu về các dịch vụ đào tạo và/hoặc chứng chỉ của Microsoft Learn
  • Kéo danh sách các dịch vụ đào tạo và/hoặc chứng nhận của Microsoft Learn để liên kết với chúng từ trải nghiệm trực tuyến của riêng bạn

CÁCH hoạt động của API Danh mục Learn

API là một API Web dựa trên REST trả về phản hồi được mã hóa JSON. Để yêu cầu danh mục đầy đủ, hãy gửi yêu cầu GET đến:

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

Đầu ra sẽ trông giống như ảnh chụp màn hình bên dưới. Kể từ tháng 11 năm 2022, phản hồi đầy đủ là khoảng 13 MB.

ảnh chụp màn hình đầu ra API Danh mục Learn trong Mã Visual Studio.

Mỗi mục ca-ta-lô học tập là một đối tượng, với một tập hợp siêu dữ liệu sẵn dùng cho từng mục. Từ điển dữ liệu đầy đủ và các tùy chọn khác được liệt kê trong tài liệu dành cho nhà phát triển API Danh mục của Microsoft Learn. Chúng tôi cũng có ghi chú phát hành (liên kết) để xem các bản cập nhật mới nhất là gì và bạn có cách tốt nhất để tin.

Nếu bạn quan tâm đến việc sử dụng tính năng này, hãy xem bài viết Bắt đầu với API Danh mục Microsoft Learn bằng cách sử dụng cURL và Mã Visual Studio.

Yêu cầu

Không cần xác thực để truy nhập API Danh mục Microsoft Learn. Người dùng có thể sử dụng phương pháp yêu cầu API ưa thích của họ, chẳng hạn như cURL, Postman, v.v.

Ví dụ

Dưới đây là một vài trong nhiều cách chúng tôi thấy người dùng sử dụng API Ca-ta-lô Học tập:

  • tìm hiểu Viva đã sử API Danh mục Learn để cung cấp danh mục Microsoft Learn như một phần trong trải nghiệm cốt lõi của danh mục.
  • Các tổ chức và tổ chức giáo dục sử dụng API Danh mục Learn để kéo thông tin danh mục và đăng thông tin đó lên hệ thống quản lý học tập nội bộ (LMS) của họ để nhân viên và học viên của họ có thể dễ dàng truy cập vào đó.
  • Các nhà cung cấp dịch vụ học tập sử dụng API Danh mục Tìm hiểu để kéo thông tin danh mục và đăng thông tin đó trong trải nghiệm học tập khách hàng của họ.

Tính khả dụng và giá cả

API Danh mục Microsoft Learn được cung cấp công khai và được cung cấp theo thuật ngữ của Điều khoản Sử dụng API của Microsoft . Bạn sẽ không phải trả phí khi sử dụng API.

Hạn chế

  • API chứa các mô-đun, đơn vị, đường dẫn học tập có sẵn công khai, các khóa học có người hướng dẫn, bài kiểm tra và chứng chỉ. Nó không xuất ra tài liệu, mẫu mã, hiển thị hoặc sự kiện tại thời điểm này.
  • API sẽ làm mới ít nhất một lần mỗi ngày.
  • Các bản cập nhật cho phiên bản API sẽ được thông báo qua các bản cập nhật cho Tìm hiểu Ghi chú Phát hành API Ca-ta-lô.

Các bước tiếp theo

Để tìm hiểu thêm về API Danh mục Tìm hiểu, hãy xem lại các bài viết sau: