Chia sẻ qua


Tài liệu tham khảo về nhà phát triển API Danh mục Microsoft Learn

Bài viết này cung cấp thông tin cho các nhà phát triển và người yêu cầu thực hiện API Danh mục của Microsoft Learn. Chúng tôi cũng khuyên bạn nên xem QUA API Danh mục Tìm hiểu cách thực hành tốt nhất, ghi chú phát hànhvà các câu hỏi thường gặp về câu hỏi bài viết để hỗ trợ hành trình phát triển của bạn.

Điểm cuối API

API Danh mục của Microsoft Learn 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/

Ghi

Điểm cuối được liệt kê ở trên là điểm cuối hiện tại. Nếu bạn đang sử dụng một điểm cuối khác, cũ hơn, điểm cuối đó vẫn sẽ hoạt động như mong đợi khi bạn triển khai, nhưng lợi ích của việc chuyển sang điểm cuối mới là điểm cuối này sẽ cung cấp cho bạn các tính năng nâng cao như tham số truy vấn bổ sung.

Tham số truy vấn

Sau đây là các tham số truy vấn mà yêu cầu có thể bao gồm. Tất cả đều là tùy chọn. Bạn phải URL mã hóa các giá trị tham số truy vấn. Bạn có thể sử dụng điểm cuối mà không có, một, một số hoặc tất cả các tham số này.

Quan trọng

Nếu bạn sử dụng nhiều truy vấn, truy vấn sẽ được đánh giá bằng toán tử AND.

Tên Giá trị Kiểu Bắt buộc Ví dụ
Locale Một mã bản địa hợp lệ duy nhất từ danh sách bản địa được hỗ trợ. Siêu dữ liệu được trả về sẽ nằm trong bản địa được yêu cầu nếu có. Nếu tham số này không được cung cấp, phản hồi en-us sẽ được trả về. xâu Không ?locale=en-us
kiểu Danh sách được phân tách bằng dấu phẩy của một hoặc nhiều đối tượng nội dung mức cao nhất hoặc các nguyên tắc phân loại mà chúng tôi hiện cung cấp để phản hồi trả về. Các giá trị được hỗ trợ là: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects. xâu Không ?type=modules,learningPaths
Uid Danh sách được phân tách bằng dấu phẩy của một hoặc nhiều ID duy nhất (uid) nội dung hợp lệ từ các loại nội dung có sẵn. lưu ý: uid có phân biệt chữ hoa chữ thường. xâu Không ?uid=learn.azure.intro-to-azure-fundamentals
last_modified Toán tử và ngày giờ để lọc theo ngày sửa đổi cuối cùng của đối tượng. Toán tử bao gồm lt (nhỏ hơn), lte (nhỏ hơn hoặc bằng), eq (bằng), gt (lớn hơn), gte (lớn hơn hoặc bằng). Khi bạn sử dụng tham số này, toán tử sẽ mặc định gte nếu không xác định. xâu Không ?last_modified=gte 2022-01-01
Phổ biến Toán tử và giá trị để lọc theo giá trị phổ biến (trong phạm vi 0-1) đối tượng. Toán tử bao gồm lt (nhỏ hơn), lte (nhỏ hơn hoặc bằng), eq (bằng), gt (lớn hơn), gte (lớn hơn hoặc bằng). Khi bạn sử dụng tham số này, toán tử sẽ mặc định gte nếu không xác định. xâu Không ?popularity=gte 0.5
mức Danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều mức mà chúng tôi hiện có sẵn (danh sách đầy đủ nằm trong các mức đối tượng của phản hồi API). xâu Không ?level=beginner
vai trò Danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều vai trò mà chúng tôi hiện có sẵn (danh sách đầy đủ nằm trong vai trò đối tượng của phản hồi API). xâu Không ?role=developer
sản phẩm Danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều vai trò mà chúng tôi hiện có sẵn (danh sách đầy đủ nằm trong các sản phẩm đối tượng của phản hồi API). API không hỗ trợ cấu trúc phân cấp sản phẩm, vì vậy hãy thêm mọi sản phẩm vào danh sách bạn muốn đưa vào truy vấn của mình. xâu Không ?product=azure
chủ đề Danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều vai trò mà chúng tôi hiện có sẵn (danh sách đầy đủ nằm trong các đối tượng đối tượng của phản hồi API). API không hỗ trợ cấu trúc phân cấp chủ đề, vì vậy hãy thêm mọi chủ đề vào danh sách bạn muốn đưa vào truy vấn của mình. xâu Không ?subject=cloud-computing

Truy vấn mẫu

Các truy vấn được liệt kê dưới đây là các mẫu để giúp bạn hiểu được những gì bạn có thể yêu cầu và cách tạo yêu cầu.

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

Phản hồi API

Dịch vụ có thể trả về các mã trạng thái HTTP sau đây.

Mã trạng thái Sự miêu tả
200 Sự thành công. Nội dung phản hồi bao gồm dữ liệu mã hóa JSON.
400 Một trong các tham số truy vấn bị thiếu hoặc không hợp lệ.
404 Không tìm thấy URL trên máy chủ.
500 Lỗi máy chủ bất ngờ.
503 Dịch vụ tạm thời không khả dụng.

Phản hồi thành công sẽ bao gồm chi tiết về tất cả các mô-đun và đường dẫn học tập, như minh họa dưới đây.

Nội dung phản hồi

Nội dung phản hồi thành công sẽ được mã hóa bằng JSON và có 12 phần:

{
    "modules": [ ... ],
    "units": [...],
    "learningPaths": [ ... ],
    "appliedSkills": [ ... ],
    "mergedCertifications": [ ... ],
    "certifications": [ ... ],
    "exams": [ ... ],
    "courses": [ ... ],
    "levels": [ ... ],
    "products": [ ... ],
    "roles": [ ... ],
    "subjects": [...],
}

Mỗi mảng có một hoặc nhiều đối tượng mã hóa JSON chứa dữ liệu cụ thể cho phần phản hồi đó.

  1. modules: là một mảng các mô-đun đã xuất bản.
  2. units: là một mảng các đơn vị đã phát hành.
  3. learningPaths: là một loạt các lộ trình học tập được xuất bản.
  4. appliedSkills: là một loạt các kỹ năng ứng dụng được xuất bản.
  5. mergedCertifications: là một loạt các chứng chỉ đã công bố được hợp nhất với các bài kiểm tra.
  6. certifications: là một loạt các chứng chỉ đã công bố.
  7. exams: là một loạt các bài kiểm tra đã công bố.
  8. courses: là một loạt các khóa đào tạo có người hướng dẫn được công bố.
  9. levels: là một mảng các mức người xem có thể có.
  10. products: là một loạt các sản phẩm và dịch vụ có thể được bao gồm trong danh mục.
  11. roles: là một mảng các vai trò công việc khả thi.
  12. subjects: là một mảng các thẻ chủ đề có thể.

Bản ghi mô-đun

Bản ghi mô-đun

Mỗi bản ghi mô-đun sẽ có biểu mẫu sau đây:

{
    "summary": "Explore the core concepts of cloud computing and how it can help your business.",
    "levels": [
        "beginner"
    ],
    "roles": [
        "administrator",
        "business-analyst",
        "developer"
    ],
    "products": [
        "azure",
        "azure-portal",
        "azure-resource-manager"
    ],
    "subjects": [
        "data-visualization"
    ],
    "uid": "learn.principles-cloud-computing",
    "type": "module",
    "title": "Cloud Concepts - Principles of cloud computing",
    "duration_in_minutes": 62,
    "rating": {
        count: 2014,
        average: 4.84
    },
    "popularity": 0.8839785477023878, 
    "icon_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing.svg",
    "social_image_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing-social.png",
    "locale": "en-us",
    "last_modified": "2018-09-24T00:00:00Z",
    "url": "https://learn.microsoft.com/learn/modules/principles-cloud-computing",
    "firstUnitUrl": "https://learn.microsoft.com/learn/modules/principles-cloud-computing/1-introduction",
    "units": [
        "learn.principles-cloud-computing.1-introduction",
        "learn.principles-cloud-computing.2-types-of-cloud-computing",
        "learn.principles-cloud-computing.3-benefits-of-cloud-computing",
        "learn.principles-cloud-computing.4-categories-of-cloud-services",
        "learn.principles-cloud-computing.5-knowledge-check",
        "learn.principles-cloud-computing.6-summary"
    ],
    "number_of_children": 6
}

Chi tiết trường

Trường Kiểu Sự miêu tả
summary xâu Chuỗi cung cấp mô tả ngắn về mô-đun. Giá trị được thể hiện dưới dạng thẻ đoạn văn HTML với văn bản bên trong là tóm tắt.
levels mảng chuỗi Danh sách các cấp độ liên kết với mô-đun này cho biết mức độ kinh nghiệm trong vai trò là cần thiết để hiểu tất cả các khía cạnh của mô-đun này. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi cấp độ.
roles mảng chuỗi Danh sách các vai trò công việc mà mô-đun này có liên quan.
products mảng chuỗi Danh sách các sản phẩm liên quan mà mô-đun này bao gồm. Chi tiết về các sản phẩm có thể được tham chiếu trong bản ghi sản phẩm.
subjects mảng chuỗi Danh sách các chủ đề liên quan mà lộ trình học tập này bao gồm.
uid xâu Mã định danh duy nhất cho mô-đun này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
type xâu Loại bản ghi. Giá trị sẽ luôn là 'mô-đun'.
title xâu Tiêu đề cho mô-đun trong ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
duration_in_minutes số nguyên Thời gian trung bình mà mô-đun này cần để hoàn thành trong vài phút.
rating đối tượng Chứa cả count, là số người đã xếp hạng mô-đun và average, tổng hợp các xếp loại, sẽ là 1-5
popularity đôi Giá trị chuẩn hóa từ 0-1 cho biết mức độ phổ biến của mô-đun
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 đại diện cho hình ảnh thành tích mô-đun với nền trong suốt.
social_image_url xâu URL đủ điều kiện đến hình ảnh PNG đại diện cho hình ảnh thành tích mô-đun với nền mờ hình chữ nhật, phù hợp cho các trải nghiệm truyền thông xã hội hoặc ô xếp. Nếu không có sẵn cho mô-đun này, thuộc tính này sẽ không được trả về trong phản hồi.
locale xâu Ngôn ngữ mà dữ liệu JSON này được viết. Giá trị này sẽ là ngôn ngữ được yêu cầu nếu có, hoặc 'en-us' nếu không.
last_modified ngày Lần cuối cùng mô-đun này có một sửa đổi lớn.
url xâu URL đủ điều kiện đến mô-đun Learn trong ngôn ngữ được yêu cầu.
firstUnitUrl xâu URL đủ điều kiện đến đơn vị đầu tiên của mô-đun Learn trong ngôn ngữ được yêu cầu.
units mảng chuỗi Danh sách các UIDs đơn vị liên quan. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi đơn vị.
number_of_children số nguyên Số trang (đơn vị) mà mô-đun này có trong đó.

Bản ghi đơn vị

Mỗi bản ghi đơn vị sẽ có biểu mẫu sau đây:

{
    "uid": "learn.azure.fundamental-azure-concepts.types-of-cloud-computing",
    "type": "unit",
    "title": "Discuss different types of cloud models",
    "duration_in_minutes": 5,
    "locale": "en-us",
    "last_modified": "2021-12-09T02:45:00+00:00"
},

Ghi

Bản ghi đơn vị không có URL liên kết vì 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 các 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 trong bản ghi mô-đun để người dùng có thể bắt đầu ở đó và tiếp tục qua nội dung. Tuy nhiên, các bản ghi đơn vị có thể được sử dụng để có được chi tiết về các đơn vị để hiển thị trong LMSes hoặc trải nghiệm khác.

Chi tiết trường

Trường Kiểu Sự miêu tả
uid xâu Mã định danh duy nhất cho mô-đun này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
type xâu Loại bản ghi. Giá trị sẽ luôn là 'đơn vị'.
title xâu Tiêu đề cho đơn vị trong ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
duration_in_minutes Thời lượng của đơn vị. Nếu bạn thêm toàn bộ thời duration_in_minutes của các đơn vị được liên kết với từng mô-đun, bạn sẽ nhận được tổng thời gian của mô-đun.
locale xâu Ngôn ngữ mà dữ liệu JSON này được viết. Giá trị này sẽ là ngôn ngữ được yêu cầu nếu có, hoặc 'en-us' nếu không.
last_modified ngày Lần cuối cùng mô-đun này có một sửa đổi lớn.

Bản ghi đường dẫn học tập

Mỗi bản ghi đường dẫn học tập sẽ có biểu mẫu sau đây:

{
    "summary": "Azure Functions enable the creation of event driven, compute-on-demand systems that can be triggered by various external events. Learn how to leverage functions to execute server-side logic and build serverless architectures.",
    "levels": [
        "beginner",
        "intermediate"
    ],
    "roles": [
        "developer",
        "solution-architect"
    ],
    "products": [
        "azure",
        "azure-portal",
        "azure-functions",
        "azure-cosmos-db",
        "azure-cloud-shell"
    ],
    "subjects": [
        "data-visualization"
    ],
    "uid": "learn.create-serverless-applications",
    "type": "learningPath",
    "title": "Create serverless applications",
    "duration_in_minutes": 450,
    "rating": {
        count: 2014,
        average: 4.84
    },
    "popularity": 0.8839785477023878, 
    "icon_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications.svg",
    "social_image_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications-social.png",
    "locale": "en-us",
    "last_modified": "2018-12-27T00:00:00Z",
    "url": "https://learn.microsoft.com/learn/paths/create-serverless-applications",
    "firstModuleUrl": "https://learn.microsoft.com/learn/modules/choose-azure-service-to-integrate-and-automate-business-processes/",
    "modules": [
        "learn.choose-azure-service-to-integrate-and-automate-business-processes",
        "learn.create-serverless-logic-with-functions",
        "learn.execute-azure-function-with-triggers",
        "learn.chain-azure-functions-data-using-input-output-bindings",
        "learn.azure-create-long-running-serverless-workflow-with-durable-functions",
        "learn-pr.develop-test-deploy-azure-functions-core-tools",
        "learn.develop-test-deploy-azure-functions-with-visual-studio",
        "learn.azure.monitor-github-events-with-a-function-triggered-by-a-webhook",
        "learn.advocates.azure-functions-and-signalr"
    ],
    "number_of_children": 9
}

Chi tiết trường

Trường Kiểu Sự miêu tả
summary xâu Chuỗi cung cấp mô tả ngắn về lộ trình học tập. Giá trị được thể hiện dưới dạng thẻ đoạn văn HTML với văn bản bên trong là tóm tắt.
levels mảng chuỗi Một danh sách các cấp độ liên quan đến lộ trình học tập này, trong đó cho biết bao nhiêu kinh nghiệm trong vai trò là cần thiết để hiểu tất cả các khía cạnh của con đường học tập này. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi cấp độ.
roles mảng chuỗi Danh sách các vai trò công việc liên quan cho lộ trình học tập này.
products mảng chuỗi Danh sách các sản phẩm liên quan mà lộ trình học tập này bao gồm. Chi tiết về các sản phẩm có thể được tham chiếu trong bản ghi sản phẩm.
subjects mảng chuỗi Danh sách các chủ đề liên quan mà lộ trình học tập này bao gồm.
uid xâu Mã định danh duy nhất cho đường dẫn học tập này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
type xâu Loại bản ghi. Giá trị sẽ luôn là 'learningPath'.
title xâu Tiêu đề cho đường dẫn học tập ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
duration_in_minutes số nguyên Thời gian trung bình để hoàn thành lộ trình học tập này chỉ trong vài phút. Giá trị này là tổng dữ liệu từ tất cả các mô-đun được bao gồm.
rating đối tượng Chứa cả count, là số người đã xếp hạng đường dẫn học tập và average, tổng số xếp loại, sẽ là 1-5
popularity đôi Một giá trị chuẩn hóa từ 0-1 cho thấy sự phổ biến của lộ trình học tập
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 đại diện cho đường dẫn tìm hiểu.
social_image_url xâu URL đủ điều kiện đến hình ảnh PNG đại diện cho hình ảnh thành tích đường dẫn học tập với nền mờ hình chữ nhật, phù hợp cho các trải nghiệm truyền thông xã hội hoặc ô xếp. Nếu không có sẵn cho mô-đun này, thuộc tính này sẽ không được trả về trong phản hồi.
locale xâu Ngôn ngữ mà dữ liệu JSON này được viết. Giá trị này sẽ là ngôn ngữ được yêu cầu nếu có, hoặc 'en-us' nếu không.
last_modified ngày Lần cuối cùng thay đổi lộ trình học tập này.
url xâu URL đủ điều kiện đến đường dẫn học tập trong Microsoft Learn trong ngôn ngữ được yêu cầu.
firstModuleUrl xâu URL đủ điều kiện đến mô-đun đầu tiên của đường dẫn học tập trong Microsoft Learn trong ngôn ngữ được yêu cầu.
modules mảng chuỗi Danh sách các UIDs mô-đun liên kết. Chi tiết về các mô-đun có thể được tham chiếu trong bản ghi mô-đun.
number_of_children số nguyên Số lượng mô-đun mà lộ trình học tập này có trong đó.

Bản ghi Kỹ năng Đã áp dụng

Mỗi bản ghi Kỹ năng Ứng dụng sẽ có biểu mẫu sau đây:

{
    "uid": "applied-skill.deploy-and-configure-azure-monitor",
    "locale": "en-us",
    "url": "https://learn.microsoft.com/en-us/credentials/applied-skills/deploy-and-configure-azure-monitor/?WT.mc_id=api_CatalogApi",
    "title": "Deploy and configure Azure Monitor",
    "summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
    "levels": [
        "intermediate"
    ],
    "roles": [
        "administrator"
    ],
    "products": [
        "azure-monitor",
        "azure-virtual-machines",
        "azure-virtual-network",
        "windows-server"
    ],
    "subjects": [
        "it-management-monitoring"
    ],
    "study_guide": [
        {
            "uid": "learn.wwl.deploy-configure-azure-monitor",
            "type": "learningPath"
        }
    ],
    "last_modified": "2023-10-25T17:07:00+00:00"
}

Chi tiết trường

Trường Kiểu Sự miêu tả
uid xâu Mã định danh duy nhất cho Kỹ năng được Áp dụng này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
locale xâu Ngôn ngữ mà dữ liệu JSON này được viết. Giá trị này sẽ là ngôn ngữ được yêu cầu nếu có, hoặc 'en-us' nếu không.
title xâu Tiêu đề cho Kỹ năng Áp dụng ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
summary xâu Tóm tắt cho Kỹ năng Áp dụng ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
url xâu URL đủ điều kiện đến Kỹ năng Được áp dụng trong Microsoft Learn trong ngôn ngữ được yêu cầu.
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 đại diện cho Kỹ năng được Áp dụng (nếu có, nếu không thì không bao gồm).
levels mảng chuỗi Danh sách các mức độ liên kết với Kỹ năng được Áp dụng này.
roles mảng chuỗi Danh sách các vai trò công việc liên quan cho Kỹ năng Được áp dụng này. Chi tiết về vai trò có thể được tham chiếu trong bản ghi vai trò.
subjects mảng chuỗi Danh sách các chủ đề liên quan mà Kỹ năng Áp dụng này bao gồm.
study_guide mảng đối tượng Danh sách các nội dung liên quan để nghiên cứu kỹ năng áp dụng này. Chi tiết về các đối tượng có thể được tham chiếu trong bản ghi liên kết của chúng.
last_modified ngày Lần cuối cùng Kỹ năng Áp dụng này được thay đổi.

Các bản ghi chứng chỉ được hợp nhất

Mỗi bản ghi chứng chỉ được hợp nhất sẽ có biểu mẫu sau đây:

{
    "uid": "certification.d365-functional-consultant-manufacturing",
    "title": "Microsoft Certified: Dynamics 365 Supply Chain Management, Manufacturing Functional Consultant Associate",
    "summary": "<div class=\"WARNING\">\n<p>Warning</p>\n<p>This certification retired on June 30, 2023. You can renew it for at least six months after the retirement date by completing the free online assessment available on the <a href=\"/credentials/certifications/d365-functional-consultant-manufacturing/renew\">certification renewal page</a>. <a href=\"https://aka.ms/BACertPortfolioUpdatesBlog\">Read the blog post</a>.</p>\n</div>\n<p>If you’re a functional consultant or a business user with a deep understanding of manufacturing industry standards, this certification might be for you. You also need experience configuring and implementing Dynamics 365 Supply Chain Management to meet the needs of your organization. Supply chain management, manufacturing functional consultants are key resources who work with developers, solution architects, project managers, and functional consultants in finance, commerce, and supply chain.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Study the supply chain management and supply chain management, manufacturing modules on Microsoft Learn, and complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course that covers the MB-300 or MB-320 track.</li>\n<li>Take part in the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>, or join a user group.</li>\n<li>Shadow a manufacturing functional consultant in a manufacturing workstream.</li>\n<li>Get a mentor, tour manufacturing lines, and learn how things are made.</li>\n<li>Ask questions, and learn from experts and customers.</li>\n</ul>\n",
    "url": "https://learn.microsoft.com/en-us/credentials/certifications/d365-functional-consultant-manufacturing/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/en-us/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
    "last_modified": "2023-09-19T00:47:00+00:00",
    "type": "cert",
    "certification_type": "role-based",
    "products": [
        "dynamics-365",
        "dynamics-finance"
    ],
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "subjects": [],
    "renewal_frequency_in_days": 0,
    "prerequisites": [],
    "skills": [
        "Describe finance and operations apps, and extend apps by using Microsoft Power Platform technologies",
        "Configure administrative features and workflows",
        "Manage finance and operations data",
        "Validate and support solutions",
        "Configure Dynamics 365 Supply Chain Management, Manufacturing",
        "Manage manufacturing processes",
        "Implement master planning for production",
        "Implement other manufacturing features"
    ],
    "recommendation_list": [],
    "study_guide": [],
    "exam_duration_in_minutes": 0,
    "locales": [],
    "providers": [],
    "career_paths": []
}

Chi tiết trường

Trường Kiểu Sự miêu tả
uid xâu Mã định danh duy nhất cho chứng chỉ này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
title xâu Tiêu đề cho chứng chỉ ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
summary xâu Bản tóm tắt cho chứng chỉ ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ dưới dạng bản dự phòng.
url xâu URL đủ điều kiện đến chứng chỉ trong Microsoft Learn ở ngôn ngữ được yêu cầu.
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 đại diện cho chứng chỉ.
last_modified ngày Lần cuối cùng chứng chỉ này được thay đổi.
type xâu Loại bản ghi. Giá trị sẽ luôn là 'cert'.
certification_type xâu Loại chứng chỉ. Các giá trị có thể là 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'.
products mảng chuỗi Danh sách các sản phẩm liên quan mà chứng nhận này bao gồm. Chi tiết về các sản phẩm có thể được tham chiếu trong bản ghi sản phẩm.
levels mảng chuỗi Danh sách các cấp độ liên quan đến chứng chỉ này, cho biết mức độ kinh nghiệm trong vai trò này là cần thiết để hiểu tất cả các khía cạnh của bài kiểm tra chứng chỉ này. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi cấp độ.
roles mảng chuỗi Danh sách các vai trò công việc liên quan cho chứng chỉ này. Chi tiết về vai trò có thể được tham chiếu trong bản ghi vai trò.
subjects mảng chuỗi Danh sách các đối tượng liên quan mà chứng chỉ này bao gồm.
renewal_frequency_in_days số nguyên Số ngày trước khi chứng chỉ này hết hạn và cần được gia hạn. Nếu giá trị bằng 0, chứng chỉ sẽ không hết hạn.
prerequisites mảng chuỗi Danh sách các điều kiện tiên quyết được đề xuất để đạt được chứng chỉ này. Thông tin chi tiết về các chứng chỉ có thể được tham chiếu trong hồ sơ chứng chỉ.
skills mảng chuỗi Danh sách các kỹ năng được đánh giá trong bài kiểm tra bắt buộc đối với chứng chỉ này.
recommendation_list mảng chuỗi Danh sách các đề xuất liên quan đến chứng chỉ này.
study_guide mảng đối tượng Danh sách các nội dung liên quan để nghiên cứu cho chứng chỉ này. Chi tiết về các đối tượng có thể được tham chiếu trong bản ghi liên kết của chúng.
exam_duration_in_minutes số nguyên Số phút được phân bổ để hoàn thành bài kiểm tra.
locales mảng chuỗi Danh sách các ngôn ngữ mà chứng chỉ này được cung cấp.
providers mảng đối tượng Danh sách các nhà cung cấp cho chứng chỉ này. Loại mô tả nhà cung cấp và URL đủ điều kiện với liên kết để lên lịch kiểm tra với nhà cung cấp.
career_paths mảng đối tượng Danh sách các con đường nghề nghiệp cho chứng chỉ này.

Ghi

Các chứng chỉ chỉ yêu cầu một bài kiểm tra sẽ được trả về như một phần của thuộc tính mergedCertifications này.

Hồ sơ chứng chỉ

Mỗi bản ghi chứng chỉ sẽ có biểu mẫu sau đây:

{
    "uid": "certification.d365-functional-consultant-customer-service",
    "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate",
    "subtitle": "Microsoft Dynamics 365 Customer Service functional consultants are responsible for implementing omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction.",
    "url": "https://learn.microsoft.com/cert-exam-sandbox/cert/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
    "type": "cert",
    "certification_type": "role-based",
    "exams": [
        "exam.77-881"
    ],
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "study_guide": [
        {
            "uid": "learn.get-started-with-d365",
            "type": "module"
        },
        {
            "uid": "learn.d365-notebook",
            "type": "module"
        },
        {
            "uid": "learn.d365-fundamentals",
            "type": "learningPath"
        }
    ]
}

Chi tiết trường

Trường Kiểu Sự miêu tả
uid xâu Mã định danh duy nhất cho chứng chỉ này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
title xâu Tiêu đề cho chứng chỉ ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
subtitle xâu Tiêu đề phụ cho chứng chỉ ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ dưới dạng bản dự phòng.
url xâu URL đủ điều kiện đến chứng chỉ trong Microsoft Learn ở ngôn ngữ được yêu cầu.
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 đại diện cho chứng chỉ.
type xâu Loại bản ghi. Giá trị sẽ luôn là 'cert'.
certification_type xâu Loại chứng chỉ. Các giá trị có thể là 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'.
exams mảng chuỗi Danh sách các bài kiểm tra liên quan cần thiết cho chứng chỉ này. Chi tiết về các đơn vị có thể được tham chiếu trong hồ sơ chứng chỉ.
levels mảng chuỗi Danh sách các cấp độ liên quan đến chứng chỉ này, cho biết mức độ kinh nghiệm trong vai trò này là cần thiết để hiểu tất cả các khía cạnh của bài kiểm tra chứng chỉ này. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi cấp độ.
roles mảng chuỗi Danh sách các vai trò công việc liên quan cho chứng chỉ này. Chi tiết về vai trò có thể được tham chiếu trong bản ghi vai trò.
study_guide mảng đối tượng Danh sách các nội dung liên quan để nghiên cứu cho chứng chỉ này. Chi tiết về các đối tượng có thể được tham chiếu trong bản ghi liên kết của chúng.

Ghi

Các chứng chỉ yêu cầu nhiều bài kiểm tra sẽ có trong bản ghi Chứng chỉ này tham chiếu mảng bài kiểm tra.

Hồ sơ thi

Mỗi hồ sơ thi sẽ có biểu mẫu sau đây:

{
    "uid": "exam.77-881",
    "title": "Word 2010",
    "subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
    "display_name": "77-881",
    "url": "https://learn.microsoft.com/cert-exam-sandbox/exam/77-881/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
    "pdf_download_url": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
    "practice_test_url": "https://www.mindhub.com/70-413-Designing-and-Implementing-a-Server-Infrast-p/mu-70-413_p.htm?utm_source=microsoft&amp;utm_medium=certpage&amp;utm_campaign=msofficialpractice",
    "practice_assessment_url": "https://learn.microsoft.com/en-us/certifications/exams/{exam}/practice/assessment?assessment-type=practice&assessmentId={assessmentId}",
    "locales": [],
    "type": "exam",
    "courses": [
        "course.pl-200t00",
        "course.mb-230t01"
    ],
    "levels": [
        "beginner"
    ],
    "roles": [
        "business-user"
    ],
    "products": [
        "office-word"
    ],
    "providers": [],
    "study_guide": [
        {
            "uid": "learn.get-started-with-word-2010",
            "type": "module"
        },
        {
            "uid": "learn.office2010-notebook",
            "type": "module"
        },
        {
            "uid": "learn.office2010-fundamentals",
            "type": "learningPath"
        }
    ]
}

Chi tiết trường

Trường Kiểu Sự miêu tả
uid xâu Mã định danh duy nhất cho bài kiểm tra này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
title xâu Tiêu đề cho bài kiểm tra ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
subtitle xâu Tiêu đề phụ cho bài kiểm tra ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ dưới dạng dự phòng.
display_name xâu Tên hiển thị cho bài kiểm tra ở ngôn ngữ được yêu cầu hoặc tiếng Anh Mỹ làm bản dự phòng.
url xâu URL đủ điều kiện đến bài kiểm tra trong Microsoft Learn ở ngôn ngữ được yêu cầu.
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 đại diện cho bài kiểm tra.
pdf_download_url xâu Một URL đủ điều kiện để PDF trình bày các kỹ năng được đo bằng bài kiểm tra này.
practice_test_url xâu Một URL đủ điều kiện đến bài kiểm tra thực hành liên quan đến bài kiểm tra.
practice_assessment_url xâu Một URL đủ điều kiện đến bài đánh giá thực hành miễn phí liên quan đến bài kiểm tra.
locales mảng chuỗi Danh sách các ngôn ngữ mà bài kiểm tra này được cung cấp.
type xâu Loại bản ghi. Giá trị sẽ luôn là 'kỳ thi'.
courses mảng chuỗi Danh sách các UID khóa học liên kết. Chi tiết về các khóa học có thể được tham chiếu trong hồ sơ khóa học.
levels mảng chuỗi Một danh sách các cấp độ liên quan đến kỳ thi này, trong đó cho biết bao nhiêu kinh nghiệm trong vai trò là cần thiết để hiểu tất cả các khía cạnh của kỳ thi này. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi cấp độ.
roles mảng chuỗi Danh sách các vai trò công việc liên quan cho kỳ thi này. Chi tiết về vai trò có thể được tham chiếu trong bản ghi vai trò.
products mảng chuỗi Danh sách các sản phẩm liên quan mà bài kiểm tra này bao gồm. Chi tiết về các sản phẩm có thể được tham chiếu trong bản ghi sản phẩm.
providers mảng đối tượng Danh sách các nhà cung cấp cho bài kiểm tra này. Loại mô tả nhà cung cấp và URL đủ điều kiện với liên kết để lên lịch kiểm tra với nhà cung cấp.
study_guide mảng đối tượng Danh sách các nội dung liên quan để học cho kỳ thi này. Chi tiết về các đối tượng có thể được tham chiếu trong bản ghi liên kết của chúng.

Bản ghi khóa học có người hướng dẫn

Mỗi bản ghi khóa học sẽ có biểu mẫu sau đây:

{
    "uid": "course.mb-230t01",
    "course_number": "MB-230T01",
    "title": "Microsoft Dynamics 365 Customer Service - added non-exist studyguide",
    "summary": "Microsoft Dynamics 365 Customer Service offers any organization an opportunity for customer success. Using tools such as automatic case creation and queue management frees up your time to dedicate it where you can have a greater impact, directly with your customers. Join our team of globally recognized experts as they take you step by step from creating cases to interacting with customers to resolving those cases. Once you’ve resolved those cases you can learn from data analysis the key details to help you resolve similar cases faster or avoid new issues altogether. A Dynamics 365 Customer Engagement Functional Consultant is responsible for performing discovery, capturing requirements, engaging subject matter experts and stakeholders, translating requirements, and configuring the solution and applications. The Functional Consultant implements a solution using out of the box capabilities, codeless extensibility, application and service integrations.",
    "duration_in_hours": 72,
    "url": "https://learn.microsoft.com/cert-exam-sandbox/course/mb-230t01/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/course.svg",
    "locales": [
        "en"
    ],
    "type": "course",
    "certification": "certification.d365-functional-consultant-customer-service",
    "exam": "exam.77-881",
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "products": [
        "dynamics-365"
    ],
    "study_guide": [
        {
            "uid": "learn.align-requirements-in-azure",
            "type": "module"
        },
        {
            "uid": "learn.manage-resources-in-azure",
            "type": "learningPath"
        }
    ]
},

Chi tiết trường

Trường Kiểu Sự miêu tả
uid xâu Mã định danh duy nhất cho khóa học do giảng viên hướng dẫn này - giá trị này sẽ là duy nhất trên tất cả MS Learn.
course_number xâu Mã định danh số khóa học do giảng viên hướng dẫn.
title xâu Tiêu đề cho khóa học có giảng viên hướng dẫn ở ngôn ngữ được yêu cầu, hoặc tiếng Anh Mỹ làm dự phòng.
summary xâu Một chuỗi cung cấp mô tả ngắn gọn về hướng dẫn viên hướng dẫn. Giá trị được thể hiện dưới dạng thẻ đoạn văn HTML với văn bản bên trong là tóm tắt.
duration_in_hours số nguyên Thời gian trung bình khóa học do giảng viên hướng dẫn này cần để hoàn thành trong giờ.
url xâu URL đầy đủ tiêu chuẩn đến trang chi tiết khóa học do giảng viên hướng dẫn dẫn trong Microsoft Learn trong ngôn ngữ được yêu cầu.
icon_url xâu URL đủ điều kiện đến hình ảnh SVG 100x100 thể hiện thành tích khóa học do giảng viên hướng dẫn.
locales mảng chuỗi Danh sách các ngôn ngữ mà khóa học do giảng viên hướng dẫn này cung cấp chính thức. Các đối tác học tập có thể hỗ trợ các ngôn ngữ khác.
type xâu Loại bản ghi. Giá trị sẽ luôn là "khóa học" cho các khóa học có giảng viên hướng dẫn.
certification xâu Chứng chỉ liên quan đến khóa học do giảng viên hướng dẫn.
exam xâu Bài kiểm tra liên quan đến khóa học do giảng viên hướng dẫn.
levels mảng chuỗi Danh sách các cấp độ liên quan đến khóa học do giảng viên hướng dẫn này hướng dẫn, cho biết mức độ kinh nghiệm trong vai trò là cần thiết để hiểu tất cả các khía cạnh của khóa học này. Chi tiết về các đơn vị có thể được tham chiếu trong bản ghi cấp độ.
study_guide mảng đối tượng Một URL đủ điều kiện đến PDF trình bày các kỹ năng được đánh giá bằng chứng chỉ này.

Bản ghi cấp độ, sản phẩm, vai trò và chủ đề

Các tuyển tập levels, products, roles, và subjects cung cấp tên thân thiện cho các giá trị được sử dụng trong mô-đun và dữ liệu đường dẫn tìm hiểu. Cả bốn bộ sưu tập đều có cùng một hình dạng:

{
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

Kết quả id khớp các giá trị cho các mức, sản phẩm, vai trò và chủ đề được bao gồm trong các mục nhập ca-ta-lô khác. Liên kết name cung cấp tên thích hợp bằng tiếng Anh cho mục nhập. Mảng children là tùy chọn và cho phép phân cấp đối với các giá trị có mối quan hệ con như sản phẩm.

Ví dụ, đây là một tập hợp các vai trò có thể có:

{
    ...
    "roles": [
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

Sau đây là tập hợp ví dụ về các sản phẩm, kèm theo con để cung cấp danh mục sản phẩm cụ thể hơn.

{
    ...
    "products": [
        {
            "id": "dotnet",
            "name": ".NET",
            "children": [
                { "id": "dotnet-core", "name": ".NET Core" },
                { "id": "dotnet-standard", "name": ".NET Standard" },
                { "id": "aspnet-core", "name": "ASP.NET Core" },
                { "id": "ef-core", "name": "Entity Framework Core" }
            ]
        },
        {
            "id": "ms-graph",
            "name": "Microsoft Graph"
        },
        {
            "id": "office",
            "name": "Office",
            "children": [
                { "id": "office-365", "name": "Office 365" },
                { "id": "office-add-ins", "name": "Office Add-ins" },
                { "id": "office-teams", "name": "Teams" }
            ]
        },
        {
            "id": "sql-server",
            "name": "SQL Server"
        },
        ...
    ]
}

Mẫu mã

Có nhiều cách để gọi API Danh mục Tìm hiểu nhưng các mẫu mã dưới đây là các ví dụ về cách sử dụng api.

jQuery

$(function() {
    var params = {
        locale:'en-us'
    };
    $.ajax({
        url: "https://learn.microsoft.com/api/learn/catalog?" + $.param(params),
            type: "GET"
    }).done(function(data) {
        alert("success");
    }).fail(function(error) {
        alert("error");
    });
})

.NET C#

public string GetCatalogData()
{
var client = new WebClient();
client.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko");
var response = client.DownloadString("https://learn.microsoft.com/api/learn/catalog?locale=en-us");
dynamic parsedJson = JsonConvert.DeserializeObject(response);
JsonConvert.SerializeObject(response, Formatting.Indented);
return Convert.ToString(response);
}

PHP sử dụng phần mở rộng cURL

<?php 

// From URL to get webpage contents. 
$url = "https://learn.microsoft.com/api/learn/catalog"; 

// Initialize a CURL session. 
$ch = curl_init(); 

// Return Page contents. 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 
//grab URL and pass it to the variable. 
curl_setopt($ch, CURLOPT_URL, $url); 

$result = curl_exec($ch); 

echo $result;

?>

PYTHON 3 sử dụng thư viện 'yêu cầu'


#!/usr/bin/env python3
#Using Python 3.8.2 install 5/6/2020

import requests
import json

#if given error 'response / requests not defined', install requests via 'pip install requests' in the command line

parameters= {"locale": "en-us"}

response = requests.get("https://learn.microsoft.com/api/learn/catalog/", parameters)

#print(response.status_code)

rawJson = response._content

#Create python objects based on the data using json.loads

data = json.loads(rawJson)

print(data)

Các bước tiếp theo

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