Các câu hỏi thường gặp về API Danh mục của Microsoft Learn

Bài viết này liệt kê các câu hỏi thường gặp về API Danh mục Microsoft Learn, kèm theo các câu trả lời và liên kết đến các thông tin khác khi cần.

Tổng quát

hỏi: Việc sử dụng API Ca-ta-lô Learn tốn bao nhiêu chi phí?

Không có chi phí để sử dụng API Danh mục Learn. Để biết thêm thông tin, hãy xem phần Tính khả dụng và Giá trong bài viết tổng quan về tính năng API danh mục Learn về API danh mục.

hỏi: Quy tắc sử dụng API Danh mục Learn là gì?

Xem danh sách Microsoft Learn và xem điều khoản Sử dụng API của Microsoft.

hỏi: Tôi có cần bật hoặc lấy khóa để sử dụng API Ca-ta-lô Learn không?

Không. API được cung cấp công khai. Xem bài viết Bắt đầu với API Danh mục Learn bằng cách sử dụng cURL và Mã Visual Studio và/hoặc bài viết Tham khảo dành cho Nhà phát triển API Danh mục Learn.

hỏi: LIỆU API này có cho phép người dùng của chúng tôi sử dụng nội dung Learn bên trong nền tảng của chúng tôi không?

Không. API Danh mục Tìm hiểu cung cấp siêu dữ liệu về nội dung và liên kết trực tiếp đến nội dung. Người dùng có thể tích hợp các liên kết này vào bất kỳ Hệ thống Quản lý Học tập (LMS) hoặc trải nghiệm web nào theo Điều khoản Sử dụng API của Microsoft.

Hỏi: Dữ liệu được trả về từ API Danh mục Learn có còn tĩnh hay thay đổi không?

Dữ liệu thay đổi bất cứ khi nào nội dung mới được thêm, sửa đổi hoặc xóa, thường là hàng ngày.

Phản hồi API

hỏi: Tôi có thể lấy tất cả dữ liệu cùng một lúc không?

Có. Sử dụng điểm cuối cơ sở, learn.microsoft.com/api/catalog nhận phản hồi đầy đủ. Xem bài viết Tham khảo dành phát triển API danh mục cho thêm thông tin yêu cầu API.

hỏi: Tôi có thể lọc trước phản hồi không?

Có. Xem các bộ lọc truy vấn có sẵn trong bài Tìm hiểu về Tài liệu tham khảo dành cho Nhà phát triển API Danh mục.

Hỏi: UIDs có duy nhất cho mỗi đối tượng nội dung không?

Có. UID là viết tắt của "Unique ID" (ID duy nhất) và là duy nhất cho mỗi đối tượng nội dung. Nếu UID thay đổi, ngay cả khi tiêu đề hoặc siêu dữ liệu khác vẫn giữ nguyên, nội dung đó được coi là đối tượng mới.

hỏi: Tại sao có thẻ HTML trong tóm tắt của mô-đun?

Chúng tôi thường cố gắng giữ định dạng của tóm tắt càng thô càng tốt, nhưng đôi khi chúng ta cần nhấn mạnh hoặc liên kết một số văn bản nhất định.

hỏi: Tại sao không có liên kết cho các đơn vị riêng lẻ?

Các đơn vị không được viết là nội dung độc lập. Chúng được dự định sẽ được thực hiện theo một thứ tự cụ thể cho mô-đun. Vì lý do này, chúng tôi bao gồm liên kết đến trang chi tiết mô-đun và đơn vị đầu tiên để người dùng có thể bắt đầu ở đó và tiếp tục qua nội dung.

Hỏi: Làm thế nào để biết nội dung mới là gì?

Giá trị last_modified cho bạn biết khi nào bản ghi được sửa đổi lần cuối.

Hỏi: Đơn có được Sign-On (SSO) cho các nối kết nội dung không?

Không phải lúc này. Chúng tôi mong muốn kích hoạt SSO trong tương lai.

Nội dung

hỏi: UID có duy nhất cho nội dung không?

Có. UID là viết tắt của "Unique ID" (ID duy nhất) và là duy nhất cho mỗi đối tượng nội dung. Nếu UID thay đổi, ngay cả khi tiêu đề hoặc siêu dữ liệu khác vẫn giữ nguyên, nội dung đó được coi là đối tượng mới.

hỏi: Tất cả các mô-đun có phải là một phần của một lộ trình học tập không?

Không. Tất cả các mô-đun đều có khả năng đứng một mình, theo nghĩa là họ dạy một kịch bản hoặc khái niệm từ đầu đến cuối bên trong chúng và không yêu cầu thực hiện các mô-đun điều kiện tiên quyết. Đối với một số người, đây là nó và họ không phải là một phần của một lộ trình học tập. Đối với những người khác, chúng đi kèm với nhau trong một hoặc nhiều lộ trình học tập đưa người dùng thông qua việc xây dựng các khái niệm nâng cao hơn. Mô-đun không nhất thiết phải là một phần của lộ trình học tập hoặc mô-đun đó có thể là một phần của một hoặc nhiều mô-đun.

Hỏi: Làm thế nào để biết khi nào nội dung đã được thêm, làm mới hoặc xóa?

Khi các đối tượng nội dung mới được thêm vào, chúng sẽ xuất hiện dưới dạng một đối tượng mới (được xác định bởi UID) trong phản hồi. Khi nội dung được sửa đổi, bạn có thể biết dựa trên giá last_modified của nó. Khi nội dung bị xóa, đối tượng nội dung sẽ bị loại bỏ khỏi phản hồi. Mặc dù đôi khi có một chút chậm trễ về nội dung được cập nhật trong phản hồi API, khi người dùng tuân theo URL đến nội dung, họ luôn nhìn thấy thông tin mới nhất. Khi nội dung bị xóa, URL cũ sẽ chuyển hướng đến nội dung hoặc trải nghiệm mới hoặc đến tùy chọn tốt nhất tiếp theo.

Đáng chú ý là nội dung đang được cập nhật liên tục. Chúng tôi phát hành các bản cập nhật khả dụng hai lần một ngày. Chúng có thể nhỏ, chẳng hạn như thay đổi văn bản phụ hoặc chính, chẳng hạn như hiệu đính, bổ sung hoặc xóa chính. Nói chung, danh mục nội dung được quản lý như một dự án mã nguồn mở lớn, được quản lý cao với hàng ngàn người đóng góp, và như vậy, thay đổi đang diễn ra mọi lúc. Nếu bạn sử dụng API Danh mục Learn trong hệ thống sản xuất của mình, bạn nên biết điều này và có thể xử lý hệ thống của mình.

Hỏi: Tôi theo một liên kết đánh dấu đến nội dung, nhưng bây giờ nó đang hiển thị cho tôi một phần nội dung khác với mong đợi. Tại sao?

Chúng tôi cố gắng đảm bảo không có ai chạm một dead-end (404) với các liên kết đến trang web của chúng tôi. Khi nội dung được sửa đổi hoặc thay thế, chúng tôi sẽ thực hiện chuyển hướng cho liên kết cũ, liên kết này sẽ tự động đưa bạn đến nội dung mới. Trong trường hợp nội dung bị phản đối và không được thay thế vì nhiều lý do khác nhau, chúng tôi sẽ chuyển hướng đến nội dung phù hợp nhất tiếp theo, có thể là phạm vi được sửa đổi một chút hoặc đến trang đích, v.v.

Hỏi: Làm thế nào để tôi có thể truy nhập vào tài liệu, video và danh mục mẫu mã?

Không có cách lập trình nào tại thời điểm này để có quyền truy nhập vào các ca-ta-lô này. Chúng tôi mong muốn cho phép truy cập có tính lập trình vào các danh mục này trong tương lai.

Localization

Hỏi: Microsoft Learn có những ngôn ngữ nào?

Microsoft Learn có hơn 65 ngôn ngữ. Bạn có thể xem danh sách đầy đủ ở đây qua chân trang (chọn ngôn ngữ bạn đang xem để xem danh sách đầy đủ).

hỏi: Nội dung có sẵn dùng bằng các ngôn ngữ khác không?

Nó phụ thuộc. Chúng tôi mong muốn làm cho nội dung có sẵn trong tất cả các ngôn ngữ mà các sản phẩm đang được dạy trong nội dung có sẵn trong. Khi học viên truy cập site Microsoft Learn ở một ngôn ngữ nhất định, nếu nội dung không sẵn dùng ở ngôn ngữ đó, người dùng sẽ thấy đầu trang và chân trang ở ngôn ngữ mong muốn và nội dung cốt lõi mặc định trở lại tiếng Anh cho đến khi có phiên bản bản địa hóa.

hỏi: Nội dung có khác nhau đối với một đối tượng nội dung nhất định hay không, tùy thuộc vào ngôn ngữ bạn xem đối tượng đó?

Có thể. Khi các bản cập nhật được phát hành lên nội dung tiếng Anh, quy trình bản địa hóa của chúng tôi sẽ hoạt động để cập nhật các phiên bản đã bản địa hóa càng sớm càng tốt – thường là trong vòng vài ngày sau thay đổi ban đầu.

Khác

hỏi: Có api báo cáo hoặc chức năng nào để nhận dữ liệu như số lần xem, số nhấp chuột, hoàn thành không?

Chúng tôi hiện không có API báo cáo. Chúng tôi có chức báo cáo của tổ chức cho phép các tổ chức báo cáo về số người dùng hoàn tất của họ.

Các bước tiếp theo

Bạn có thể tìm hiểu thêm về API Danh mục Tìm hiểu bằng cách truy cập các liên kết sau:

• tổng quan về tính năng API Danh mục của Microsoft Learn
• đầu với API Danh mục Microsoft Learn