Đọc bằng tiếng Anh

Chia sẻ qua

Bắt đầu với API Danh mục Microsoft Learn bằng cách sử dụng curl và Mã Visual Studio

  • Bài viết

Bài viết này sẽ giúp bạn bắt đầu sử dụng API Danh mục Microsoft Learn với curl và Mã Visual Studio. Nếu bạn không quen thuộc với các chi tiết của API hoặc các trường hợp sử dụng đối với API, chúng tôi khuyên bạn nên xem lại bài viết tổng quan về tính năng API danh mục Learn trước tiên.

Quy trình cấp cao mà chúng tôi sẽ thực hiện là:

  1. Truy vấn API Ca-ta-lô Học tập
  2. Xem lại phản hồi ban đầu
  3. "Điều chỉnh trước" phản hồi
  4. Chuyển đổi bảng tính thành bảng tính
  5. Thử truy vấn khác

Sau khi bạn bắt đầu sử dụng API Danh mục Learn cho nhu cầu của riêng mình, bạn có thể thấy mình sửa đổi các bước này một chút, cho bộ công cụ hoặc nhu cầu mong muốn của bạn, nhưng nói chung quá trình sử dụng nó giống nhau cho tất cả các trường hợp sử dụng.

Điều kiện tiên quyết

Để làm theo các bước trong bài viết này, bạn sẽ cần curl và Visual Studio Code, hai công cụ phổ biến, miễn phí để truy vấn API.

  • Nếu bạn đã cài đặt curl và Visual Studio Code, bạn có thể chuyển thẳng đến phần Truy vấn Learn Catalog API.
  • Nếu bạn chưa cài đặt, hãy làm theo hướng dẫn trong các mục sau.

Tải xuống và thiết lập cuộn dây

curl là một công cụ dòng lệnh phổ biến, miễn phí, mã nguồn mở có thể truy vấn API.

  1. Truy cập trang tải cuộn cuộn và tải xuống gói có thể áp dụng cho môi trường của bạn. Nếu bạn không chắc nên chọn tùy chọn nào, hãy sử dụng trình hướng dẫn Tải cuộn cuộn.
  2. Cài đặt ứng dụng và làm theo lời nhắc để cấu hình. Không cần thiết đặt duy nhất cho bài viết này hoặc để truy vấn API Ca-ta-lô Học tập.

Tải xuống và thiết lập Visual Studio Code

Mã Visual Studio là trình soạn thảo mã miễn phí, mạnh mẽ do Microsoft tạo ra.

  1. Truy cập web Visual Studio Code và tải xuống gói có thể áp dụng cho môi trường của bạn.
  2. Cài đặt ứng dụng và làm theo lời nhắc để cấu hình.

Truy vấn API Ca-ta-lô Học tập

Vì không cần xác thực để sử dụng API Danh mục Learn, bạn có thể truy vấn điểm cuối API từ bất kỳ dòng lệnh nào được bật curl. Đối với bài tập này, chúng tôi sẽ sử dụng các thiết bị đầu cuối trong Visual Studio Code.

  1. Mở Mã Visual Studio.
  2. Chọn Thiết bị đầu cuối trong dẫn hướng trên cùng.
  3. Chọn Thiết bị đầu cuối mới để mở một thiết bị đầu cuối lệnh mới.
  4. Chọn thiết bị đầu cuối lựa chọn của bạn (Bash, CMD, v.v.) và nhập lệnh dưới đây. Lệnh dưới đây cho biết rằng nó muốn sử dụng curl, gọi điểm cuối API Danh mục Learn chưa được lọc và sẽ xuất phản hồi cho một tệp được gọi là "output.json", trong vị trí được xác định trong đường dẫn tệp được hiển thị trong thiết bị đầu cuối (ví dụ: C:\Users\<username>):
HTML 
curl https://learn.microsoft.com/api/catalog >> output.json
  1. Nếu yêu cầu thành công, bạn sẽ thấy thông tin về tổng kích cỡ tệp, chẳng hạn như 13,1 M (kích cỡ có thể thay đổi, tùy thuộc vào kích cỡ phản hồi). Nếu không thành công, bạn sẽ nhận được lỗi.

Lưu ý

Bạn nên xóa tệp output.json sau khi sử dụng xong hoặc đổi tên tệp để có thể áp dụng hơn. Nếu bạn truy vấn LẠI API bằng cùng một tên tệp, API sẽ gắn thêm phản hồi trong tệp hiện có. Một tùy chọn khác là đặt tên tệp duy nhất hơn trong lệnh truy vấn ban đầu như "output-1212.json" hoặc "output-de-de-2022-12-12.json".

Xem lại phản hồi ban đầu

Phản hồi ban đầu là theo đơn vị JSON và sẽ được "thu nhỏ cực tiểu", có nghĩa là một số khoảng trắng, dòng và tab nhất định sẽ được loại bỏ để thu nhỏ tệp.

  1. Trong Mã Visual Studio, chọn Tệp.
  2. Chọn Mở Tệp.
  3. Dẫn hướng đến tệp "output.json" đã được tạo như một phần của phần trước đó.

Việc thu nhỏ này là một phương pháp tiêu chuẩn và tệp có thể được "xác định trước" để dễ đọc hơn bằng một lệnh trong Visual Studio Code, điều chúng tôi sẽ thực hiện trong mục tiếp theo.

Điều chỉnh trước phản hồi

  1. Với tệp "output.json" mở trong Mã Visual Studio, hãy sử dụng Ctrl+Shift+I.

JSON sẽ cập nhật để tách thành nhiều dòng và ở định dạng dễ đọc hơn. Để biết thông tin về các thuộc tính và giá trị khác nhau trong phản hồi, hãy xem bài viết tham khảo về Nhà phát triển API Ca-ta-lô cho từ điển dữ liệu.

Chuyển đổi phản hồi thành bảng tính

Có rất nhiều người sử dụng API Danh mục Learn cho các tác vụ cá nhân hoặc xem xét, trái ngược với tích hợp nó vào một hệ thống. Đối với những trường hợp sử dụng này, có thể sẽ hữu ích nếu bạn chuyển đổi phản hồi JSON thành định dạng CSV hoặc Excel để xem dưới dạng bảng tính. Bạn có thể sử dụng bất kỳ công cụ chuyển đổi ưa thích nào, nhưng ở đây chúng tôi có thể sử dụng công cụ chuyển đổi Flatfile Json sang bộ chuyển đổi CSV.

  1. Đi tới: https://csvjson.com/json2csv.
  2. Tải lên tệp đầu ra của bạn.
  3. Chọn Chuyển đổi.
  4. Chọn Tải xuống.

Lưu ý

Hãy thận trọng khi sử dụng các công cụ trực tuyến bên ngoài để chuyển đổi dữ liệu và xem xét những dữ liệu bạn đang đưa vào đó. Trong trường hợp API Danh mục Tìm hiểu, phản hồi sẽ sẵn dùng công khai và không yêu cầu xác thực, vì vậy bạn có thể sử dụng công cụ trực tuyến để giúp chuyển đổi định dạng.

Thử truy vấn khác

Hãy làm theo các bước ở trên để thử các truy vấn khác, chẳng hạn như các truy vấn được liệt kê bên dưới. Xem kích cỡ tệp phản hồi thay đổi như thế nào đối với từng đối tượng và sự khác biệt trong các đối tượng bên trong.

Sự miêu tả Truy vấn
Tất cả các mục trong API Ca-ta-lô Học tập https://learn.microsoft.com/api/catalog/
Tất cả các mô-đun tiếng Tây Ban Nha https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules
Tất cả các mô-đun có điểm phổ biến từ 0,9 trở lên https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9
Tất cả các đối tượng đào tạo bảo mật và chứng nhận mới bắt đầu https://learn.microsoft.com/api/catalog/?level=beginner&subject=security
Tất cả các mô-đun trợ năng nâng cao có điểm phổ biến trên 0,5 và được cập nhật trong tháng trước https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01

Các bước tiếp theo

Chúng tôi khuyên bạn nên xem lại các tài nguyên bên dưới để giúp bạn trên hành trình phát triển của mình: