Tìm hiểu tài liệu tham khảo dành cho nhà phát triển API nền tảng

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

Điểm cuối API

Điểm cuối danh mục API Nền tảng Microsoft Learn là một tập hợp các API Web dựa trên REST được xác thực trả về phản hồi được mã hóa JSON.

Các điểm cuối có thể truy cập tại:

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

Lưu ý

Nếu bạn đang sử dụng một điểm cuối khác, cũ hơn, nó sẽ vẫn hoạt động như mong đợi cho đến tháng 6 năm 2026, tại thời điểm đó, API Danh mục cũ hơn chưa được xác thực sẽ bắt đầu ngừng hoạt động. Nếu bạn có thêm câu hỏi, hãy liên hệ với LearnPlatformAPIMigration@microsoft.com.

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

Xác thực

API REST của Nền tảng Learn sử dụng Microsoft Entra ID để xác thực. Trước khi thực hiện lệnh gọi API, bạn cần chọn phương thức truy cập và ứng dụng khách của bạn phải xác thực bằng thông tin đăng nhập hợp lệ.

Quyền truy cập chỉ ứng dụng

Khi ứng dụng của bạn truy cập trực tiếp vào Tìm hiểu, quyền truy cập của ứng dụng đó không bị ràng buộc với bất kỳ người dùng nào. Ứng dụng gọi API trực tiếp bằng danh tính của chính nó, trường hợp này là quyền truy cập chỉ ứng dụng. Tìm hiểu thêm về nền tảng danh tính của Microsoft.

Để bắt đầu, bạn cần có danh tính hợp lệ trên Nền tảng Danh tính Microsoft, có thể là đăng ký ứng dụng hoặc danh tính được quản lý. Lý tưởng nhất là mỗi đối tác nên có một danh tính duy nhất để đơn giản hóa hạn ngạch và quản lý đối tác. Sử dụng danh tính được quản lý do người dùng chỉ định có thể giúp hợp nhất danh tính được quản lý trên các dịch vụ khác nhau.

Sau khi danh tính Entra ID của bạn được thiết lập, hãy lấy mã truy cập từ Entra ID với phạm vi được đặt làm https://learn.microsoft.com/.default bằng chứng xác thực. Bao gồm mã truy cập trong tiêu đề Ủy quyền HTTP khi thực hiện yêu cầu API REST cho Learn.

Quyền truy cập được ủy quyền

Khi người dùng đăng nhập vào ứng dụng của bạn và sử dụng ứng dụng đó để truy cập Tìm hiểu, trước tiên ứng dụng sẽ cần yêu cầu quyền truy cập vào tài nguyên này thay mặt người dùng. Kịch bản này được gọi là quyền truy cập được ủy quyền. Tìm hiểu thêm về nền tảng danh tính của Microsoft.

Để bắt đầu, bạn cần đăng ký đăng ký ứng dụng. Sau khi thiết lập đăng ký ứng dụng, ứng dụng của bạn cần yêu cầu người dùng cấp một phạm vi cụ thể hoặc tập hợp các phạm vi để thay mặt người dùng truy cập Tìm hiểu. Learn cung cấp danh sách các phạm vi để truy cập tài nguyên chi tiết. Danh sách các phạm vi bao gồm:

https://learn.microsoft.com/PublicContent.Read.All: Phạm vi này cho phép người dùng truy cập nội dung công khai trên Learn mạo danh người dùng đã đăng nhập.

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. Chỉ cần phiên bản api và phiên bản hiện tại là 2023-11-01-preview. Bạn phải mã hóa URL các giá trị tham số truy vấn. Bạn có thể sử dụng điểm cuối với một, một số hoặc tất cả các tham số này.

Quan trọng

Nếu bạn sử dụng nhiều thay đổi, truy vấn sẽ được đánh giá bằng toán tử AND; Các giá trị được phân tách bằng dấu phẩy bên trong bộ lọc được kết hợp OR.

Tên	Giá trị	Loại	Bắt buộc	Ví dụ
Phiên bản API	Phiên bản API được chỉ định dưới dạng tham số truy vấn phiên bản api và sử dụng yyyy-MM-dd cho phiên bản ổn định và yyyy-MM-dd-preview cho phiên bản xem trước. Tham số truy vấn phiên bản api là bắt buộc đối với mọi yêu cầu API.	chuỗi	Có	`?api-version=2023-11-01-preview`
bản địa, địa phương	Một mã ngôn ngữ hợp lệ duy nhất từ danh sách ngôn ngữ được hỗ trợ. Siêu dữ liệu được trả về sẽ ở ngôn ngữ được yêu cầu nếu có. Nếu thông số này không được cung cấp, phản `en-us` hồi sẽ được trả về.	chuỗi	No	`?locale=en-us`
id	Danh sách được phân tách bằng dấu phẩy gồm 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 phân biệt chữ hoa chữ thường.	chuỗi	No	`?uid=learn.azure.intro-to-azure-fundamentals`
updatedAt.gt	Toán tử và ngày giờ để lọc theo ngày sửa đổi cuối cùng của các đối tượng. Toán tử bao gồm `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 nếu `gt` không được chỉ định.	chuỗi	No	`?updatedAt.gt=2022-01-01`
Cấp độ	Danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều cấp độ mà chúng tôi hiện có sẵn (danh sách đầy đủ nằm trong đối tượng cấp độ của phản hồi API).	chuỗi	No	`?levels=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 đối tượng vai trò của phản hồi API).	chuỗi	No	`?roles=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 đối tượng sản phẩm của phản hồi API). API không hỗ trợ hệ thống 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.	chuỗi	No	`?products=azure`
Đối tượng	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 đối tượng chủ đề của phản hồi API). API không hỗ trợ hệ thống 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.	chuỗi	No	`?subjects=cloud-computing`
Kích thước trang tối đa	Số lượng tài nguyên tối đa để đưa vào một phản hồi. Giá trị mặc định là 30. Giá trị tối đa cho phép là 100.	chuỗi	No	`?maxpagesize=50`

Phản hồi API

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

Mã trạng thái	Description
200	Thành công. Nội dung của phản hồi bao gồm dữ liệu được 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ệ.
401	Truy vấn trái phép.
404	URL không được tìm thấy trên máy chủ.
429	Yêu cầu có giới hạn tỷ lệ.
500	Lỗi máy chủ không mong muốn.
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 thông tin chi tiết cho từng điểm cuối, như được hiển thị bên dưới.

Nội dung phản hồi

Phản hồi mô-đun

Bản ghi mô-đun

Mỗi bản ghi mô-đun sẽ có dạng sau:

{
  "type": "module",
  "id": "learn.wwl.fundamentals-generative-ai",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/",
  "locale": "en-us",
  "title": "Introduction to generative AI and agents",
  "durationInMinutes": 37,
  "summary": "Ever wondered how AI can create content, answer questions, and assist with tasks? This module introduces you to the world of generative AI and agents.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/fundamentals-generative-ai.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "units": [
    {
      "id": "learn.wwl.fundamentals-generative-ai.introduction"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.language-models"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.writing-prompts"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.agents"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.exercise-ai-agent"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.knowledge-check"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.summary"
    }
  ],
  "updatedAt": "2025-12-23T00:20:00.0000000Z"
}

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `module`.
`id`	`string`	Có	Mã định danh mô-đun duy nhất trên toàn cầu.
`url`	`uri`	Có	URL đủ điều kiện đến mô-đun trong ngôn ngữ được yêu cầu.
`locale`	`string`	Có	Ngôn ngữ nội dung mô-đun. Mặc định là `en-us` nếu ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề mô-đun được bản địa hóa.
`durationInMinutes`	`integer`	Có	Thời gian hoàn thành mô-đun trung bình tính bằng phút.
`summary`	`string`	Có	Mô tả ngắn gọn về mô-đun.
`iconUrl`	`uri`	Có	URL đến biểu tượng mô-đun trong suốt 100×100 SVG.
`levels`	`Level[]`	Có	Mức độ kinh nghiệm liên quan đến mô-đun này.
`roles`	`Role[]`	Có	Vai trò công việc có liên quan.
`products`	`Product[]`	Có	Phân loại sản phẩm có liên quan.
`subjects`	`Subject[]`	Có	Phân loại môn học có liên quan.
`units`	`UnitReference[]`	Có	Các đơn vị học tập liên quan.
`updatedAt`	`date-time`	Có	Dấu thời gian cập nhật gần đây nhất (có thể không thay đổi khi sửa đổi nhỏ).

Hồ sơ đơn vị

Mỗi hồ sơ đơn vị sẽ có hình thức như sau:

{ 
"type": "unit",
  "id": "learn.wwl.fundamentals-generative-ai.agents",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/7-agents/",
  "locale": "en-us",
  "title": "AI agents",
  "durationInMinutes": 5,
  "updatedAt": "2025-10-06T17:09:00.0000000Z"
},

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `unit`.
`id`	`string`	Có	Mã định danh duy nhất cho đơn vị này trên Microsoft Learn.
`url`	`uri`	Có	URL đủ điều kiện cho đơn vị ở ngôn ngữ được yêu cầu.
`locale`	`string`	Có	Ngôn ngữ của đơn vị; quay trở lại nếu `en-us` ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề đơn vị được bản địa hóa (dự phòng: Tiếng Anh Mỹ).
`durationInMinutes`	`integer`	Có	Thời gian hoàn thành trung bình tính bằng phút.
`updatedAt`	`date-time`	Có	Dấu thời gian cập nhật lần cuối; có thể không thay đổi đối với các sửa đổi nhỏ.

Bản ghi lộ trình học tập

Mỗi bản ghi lộ trình học tập sẽ có dạng sau:

{
  "type": "learningPath",
  "id": "learn.introduction-ai-azure",
  "url": "https://learn.microsoft.com/training/paths/introduction-to-ai-on-azure/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "durationInMinutes": 669,
  "summary": "This course introduces core concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions, focusing on Microsoft Foundry.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/document-intelligence-knowledge-mining.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "modules": [
    {
      "id": "learn.wwl.get-started-ai-fundamentals"
    },
    {
      "id": "learn.wwl.get-started-ai-in-foundry"
    },
    {
      "id": "learn.wwl.fundamentals-machine-learning"
    },
    {
      "id": "learn.wwl.design-machine-learning-model-training-solution"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai"
    },
    {
      "id": "learn.wwl.get-started-generative-ai-azure"
    },
    {
      "id": "learn.wwl.introduction-language"
    },
    {
      "id": "learn.wwl.get-started-language-azure"
    },
    {
      "id": "learn.wwl.introduction-ai-speech"
    },
    {
      "id": "learn.wwl.recognize-synthesize-speech"
    },
    {
      "id": "learn.wwl.introduction-computer-vision"
    },
    {
      "id": "learn.wwl.get-started-computer-vision"
    },
    {
      "id": "learn.wwl.introduction-information-extraction"
    },
    {
      "id": "learn.wwl.ai-information-extraction"
    }
  ],
  "updatedAt": "2025-12-12T00:08:00.0000000Z"
}

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `learningPath`.
`id`	`string`	Có	Mã định danh duy nhất cho lộ trình học tập này trên Microsoft Learn.
`url`	`uri`	Có	URL đủ điều kiện đến lộ trình học tập ở ngôn ngữ được yêu cầu.
`locale`	`string`	Có	Ngôn ngữ mà lộ trình học tập được viết; quay trở lại nếu `en-us` ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề lộ trình học tập được bản địa hóa.
`durationInMinutes`	`integer`	Có	Thời gian hoàn thành trung bình cho lộ trình học tập tính bằng phút.
`summary`	`string`	Có	Mô tả ngắn gọn về lộ trình học tập.
`iconUrl`	`uri`	Có	URL đến biểu tượng 100×100 SVG đại diện cho lộ trình học tập.
`levels`	`Level[]`	Có	Mức độ kinh nghiệm liên quan đến lộ trình học tập.
`roles`	`Role[]`	Có	Vai trò công việc có liên quan.
`products`	`Product[]`	Có	Phân loại sản phẩm có liên quan.
`subjects`	`Subject[]`	Có	Phân loại môn học có liên quan.
`modules`	`ModuleReference[]`	Có	Tham chiếu mô-đun liên quan.
`updatedAt`	`date-time`	Có	Dấu thời gian cập nhật lần cuối; có thể không thay đổi đối với các sửa đổi nhỏ.

Hồ sơ Kỹ năng Ứng dụng

Mỗi hồ sơ Kỹ năng ứng dụng sẽ có hình thức sau:

{
  "type": "appliedSkills",
  "id": "applied-skill.deploy-and-configure-azure-monitor",
  "locale": "en-us",
  "title": "Microsoft Applied Skills: 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",
  "iconUrl": "https://learn.microsoft.com/",
  "url": "https://learn.microsoft.com/credentials/applied-skills/deploy-and-configure-azure-monitor/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "administrator",
      "name": "Administrator"
    }
  ],
  "products": [
    {
      "id": "azure-monitor",
      "name": "Azure Monitor"
    },
    {
      "id": "azure-virtual-machines",
      "name": "Azure Virtual Machines"
    },
    {
      "id": "azure-virtual-network",
      "name": "Azure Virtual Network"
    },
    {
      "id": "windows-server",
      "name": "Windows Server"
    }
  ],
  "subjects": [
    {
      "id": "it-management-monitoring",
      "name": "IT management and monitoring"
    }
  ],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `appliedSkills`.
`id`	`string`	Có	Mã định danh duy nhất cho kỹ năng được áp dụng này trên Microsoft Learn.
`locale`	`string`	Có	Ngôn ngữ mà kỹ năng được áp dụng được viết; quay trở lại nếu `en-us` ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề kỹ năng áp dụng được bản địa hóa.
`summary`	`string`	Có	Mô tả ngắn gọn về kỹ năng được áp dụng.
`iconUrl`	`uri`	Có	URL đến biểu tượng 100×100 SVG đại diện cho kỹ năng được áp dụng.
`url`	`uri`	Có	URL đủ điều kiện cho kỹ năng được áp dụng ở ngôn ngữ được yêu cầu.
`levels`	`Level[]`	Có	Mức độ kinh nghiệm liên quan đến kỹ năng được áp dụng này.
`roles`	`Role[]`	Có	Vai trò công việc có liên quan.
`products`	`Product[]`	Có	Phân loại sản phẩm có liên quan.
`subjects`	`Subject[]`	Có	Phân loại môn học có liên quan.
`updatedAt`	`date-time`	Có	Dấu thời gian cập nhật lần cuối; có thể không thay đổi đối với các bản cập nhật nhỏ.

Hồ sơ chứng nhận

Mỗi hồ sơ chứng nhận sẽ có hình thức như sau:

{
  "type": "certification",
  "id": "certification.d365-functional-consultant-customer-service",
  "locale": "en-us",
  "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate (Legacy with Power Platform)",
  "subtitle": "<p>If you’re a functional consultant responsible for configuring and implementing Dynamics 365 solutions for customers, you can use this certification to shine a light on your skills and to help advance your career. A Dynamics 365 Customer Service functional consultant implements omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction. As a functional consultant, you know how to work with project managers, developers, and solution architects. You need a minimum of one to three years of experience as a functional consultant implementing Dynamics 365.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Work as a Dynamics 365 functional consultant on one or more projects.</li>\n<li>Work on a Dynamics 365 Customer Service implementation.</li>\n<li>Join the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>.</li>\n<li>Take available learning paths on <a href=\"/training/browse/?expanded=dynamics-365&amp;products=dynamics-customer-service&amp;roles=functional-consultant&amp;resource_type=learning%20path\">Microsoft Learn</a>.</li>\n<li>Complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course.</li>\n</ul>\n<div class=\"WARNING\">\n<p>Warning</p>\n<p>This version of the certification is no longer available. <a href=\"https://techcommunity.microsoft.com/t5/microsoft-learn-blog/new-exam-structure-for-dynamics-365-certifications-for-customer/ba-p/3500861\">Read this blog post for more information about this change</a>.</p>\n</div>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/d365-functional-consultant-customer-service-legacy-with-power-platform/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-analyst",
      "name": "Business Analyst"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "functional-consultant",
      "name": "Functional Consultant"
    }
  ],
  "products": [
    {
      "id": "power-apps",
      "name": "Power Apps"
    },
    {
      "id": "power-bi",
      "name": "Power BI"
    },
    {
      "id": "power-automate",
      "name": "Power Automate"
    },
    {
      "id": "dataverse",
      "name": "Microsoft Dataverse"
    },
    {
      "id": "ai-builder",
      "name": "AI Builder"
    },
    {
      "id": "power-platform",
      "name": "Microsoft Power Platform"
    },
    {
      "id": "office-teams",
      "name": "Microsoft Teams"
    },
    {
      "id": "microsoft-copilot-studio",
      "name": "Microsoft Copilot Studio"
    },
    {
      "id": "dynamics-365",
      "name": "Dynamics 365"
    },
    {
      "id": "dynamics-customer-service",
      "name": "Customer Service"
    }
  ],
  "subjects": [],
  "certificationType": {
    "id": "role-based",
    "name": "role-based"
  },
  "renewalFrequencyInDays": 0,
  "prerequisites": [],
  "exams": [
    {
      "id": "exam.mb-230"
    }
  ],
  "updatedAt": "2024-10-08T15:40:00.0000000Z"
}

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `certification`.
`id`	`string`	Có	Mã định danh duy nhất cho chứng nhận này trên Microsoft Learn.
`locale`	`string`	Có	Ngôn ngữ chứng nhận được viết; quay trở lại nếu `en-us` ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề chứng nhận được bản địa hóa.
`subtitle`	`string`	Có	Phụ đề chứng nhận được bản địa hóa.
`iconUrl`	`uri`	Có	URL đến biểu tượng 100×100 SVG đại diện cho giấy chứng nhận.
`url`	`uri`	Có	URL đủ điều kiện đến giấy chứng nhận ở ngôn ngữ được yêu cầu.
`levels`	`Level[]`	Có	Mức độ kinh nghiệm liên quan đến chứng nhận này.
`roles`	`Role[]`	Có	Vai trò công việc có liên quan.
`products`	`Product[]`	Có	Phân loại sản phẩm có liên quan.
`subjects`	`Subject[]`	Có	Phân loại môn học có liên quan.
`certificationType`	`Taxonomy`	Có	Phân loại đại diện cho loại chứng nhận.
`renewalFrequencyInDays`	`integer`	Có	Số ngày trước khi chứng nhận này hết hạn; `0` có nghĩa là nó không hết hạn.
`prerequisites`	`string[]`	Có	Danh sách các điều kiện tiên quyết được đề xuất để đạt được chứng nhận này.
`exams`	`ExamReference[]`	Có	Các bài kiểm tra liên quan bắt buộc đối với chứng nhận này.
`updatedAt`	`date-time`	Có	Dấu thời gian của bản cập nhật cuối cùng; có thể không thay đổi đối với các sửa đổi nhỏ.

Hồ sơ thi

Mỗi hồ sơ thi sẽ có hình thức như sau:

{
  "type": "exam",
  "id": "exam.77-881",
  "locale": "en-us",
  "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.",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/exams/77-881/",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-user",
      "name": "Business User"
    }
  ],
  "products": [
    {
      "id": "office-word",
      "name": "Word"
    }
  ],
  "locales": [],
  "examNumber": "77-881",
  "pdfUrl": "https://learn.microsoft.comhttps//query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
  "practiceAssessmentUrl": "https://learn.microsoft.com/",
  "providers": [],
  "courses": [],
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `exam`.
`id`	`string`	Có	Mã định danh duy nhất cho kỳ thi này trên Microsoft Learn.
`locale`	`string`	Có	Ngôn ngữ bài kiểm tra được viết; quay trở lại nếu `en-us` ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề bài thi được bản địa hóa.
`subtitle`	`string`	Có	Phụ đề bài kiểm tra được bản địa hóa.
`iconUrl`	`uri`	Có	URL đến biểu tượng 100×100 SVG đại diện cho kỳ thi.
`url`	`uri`	Có	URL đủ điều kiện đến kỳ thi ở ngôn ngữ được yêu cầu.
`levels`	`Level[]`	Có	Mức độ kinh nghiệm liên quan đến kỳ thi này.
`roles`	`Role[]`	Có	Vai trò công việc có liên quan.
`products`	`Product[]`	Có	Phân loại sản phẩm có liên quan.
`locales`	`Locale[]`	Có	Các ngôn ngữ mà kỳ thi được cung cấp chính thức.
`examNumber`	`string`	Có	Mã định danh số thi.
`pdfUrl`	`uri`	No	URL đến PDF "Kỹ năng được đo lường" cho kỳ thi này.
`practiceAssessmentUrl`	`uri`	No	URL đến bài đánh giá thực hành miễn phí cho kỳ thi này.
`providers`	`Provider[]`	No	Các nhà cung cấp cung cấp bài kiểm tra này.
`courses`	`Course[]`	No	Các khóa học do người hướng dẫn liên quan đến kỳ thi này.
`studyGuide`	`StudyGuideRef[]`	No	Nội dung hướng dẫn học tập liên quan (tài liệu tham khảo đa hình).
`updatedAt`	`date-time`	Có	Dấu thời gian cập nhật lần cuối; có thể không thay đổi đối với các sửa đổi nhỏ.

Hồ sơ khóa học do người hướng dẫn

Mỗi hồ sơ khóa học sẽ có hình thức như sau:

{
  "type": "course",
  "id": "course.ai-900t00",
  "url": "https://learn.microsoft.com/training/courses/ai-900t00/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "summary": "<p>This course introduces fundamentals concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions. The course is not designed to teach students to become professional data scientists or software developers, but rather to build awareness of common AI workloads and the ability to identify Azure services to support them. The course is designed as a blended learning experience that combines instructor-led training with online materials on the Microsoft Learn platform (<a href=\"https://azure.com/learn\">https://azure.com/learn</a>). The hands-on exercises in the course are based on Learn modules, and students are encouraged to use the content on Learn as reference materials to reinforce what they learn in the class and to explore topics in more depth.</p>\n<h4 id=\"audience-profile\">Audience Profile</h4>\n<p>The Introduction to AI in Azure course is designed for anyone interested in learning about the types of solution artificial intelligence (AI) makes possible, and the services on Microsoft Azure that you can use to create them. You don’t need to have any experience of using Microsoft Azure before taking this course, but a basic level of familiarity with computer technology and the Internet is assumed. Some of the concepts covered in the course require a basic understanding of mathematics, such as the ability to interpret charts. The course includes hands-on activities that involve working with data and running code, so a knowledge of fundamental programming principles will be helpful.</p>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/course.svg",
  "courseNumber": "AI-900T00",
  "durationInHours": 24,
  "locales": [
    {
      "id": "en",
      "name": "en"
    },
    {
      "id": "ar",
      "name": "ar"
    },
    {
      "id": "zh-cn",
      "name": "zh-cn"
    },
    {
      "id": "zh-tw",
      "name": "zh-tw"
    },
    {
      "id": "fr",
      "name": "fr"
    },
    {
      "id": "de",
      "name": "de"
    },
    {
      "id": "id",
      "name": "id"
    },
    {
      "id": "it",
      "name": "it"
    },
    {
      "id": "ja",
      "name": "ja"
    },
    {
      "id": "ko",
      "name": "ko"
    },
    {
      "id": "pt-br",
      "name": "pt-br"
    },
    {
      "id": "ru",
      "name": "ru"
    },
    {
      "id": "es",
      "name": "es"
    }
  ],
  "levels": [],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    }
  ],
  "products": [
    {
      "id": "azure",
      "name": "Azure"
    }
  ],
  "certification": {
    "id": "certification.azure-ai-fundamentals"
  },
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
},

Thông tin chi tiết về tài sản

Thuộc tính	Loại	Bắt buộc	Description
`type`	`enum`	Có	Phân biệt loại. Được phép: `course`.
`id`	`string`	Có	Mã định danh duy nhất cho khóa học này trên Microsoft Learn.
`url`	`uri`	Có	URL đủ điều kiện đến khóa học ở ngôn ngữ được yêu cầu.
`locale`	`string`	Có	Ngôn ngữ khóa học được viết; quay trở lại nếu `en-us` ngôn ngữ được yêu cầu không khả dụng.
`title`	`string`	Có	Tiêu đề khóa học được bản địa hóa.
`summary`	`string`	Có	Mô tả ngắn gọn về khóa học.
`iconUrl`	`uri`	Có	URL đến biểu tượng 100×100 SVG đại diện cho khóa học.
`courseNumber`	`string`	Có	Số khóa học do người hướng dẫn dẫn dắt.
`durationInHours`	`integer`	Có	Thời gian trung bình để hoàn thành khóa học (tính bằng giờ).
`locales`	`Locale[]`	Có	Ngôn ngữ khóa học được cung cấp chính thức; Các ngôn ngữ khác có thể được hỗ trợ bởi các đối tác.
`levels`	`Level[]`	Có	Mức độ kinh nghiệm liên quan đến khóa học này.
`roles`	`Role[]`	Có	Vai trò công việc có liên quan.
`products`	`Product[]`	Có	Phân loại sản phẩm có liên quan.
`exam`	`ExamRef`	No	Kỳ thi liên quan cho khóa học này.
`certification`	`CertRef`	No	Chứng chỉ liên quan cho khóa học này.
`studyGuide`	`StudyGuideRef[]`	No	Tài liệu nghiên cứu liên quan (tài liệu tham khảo đa hình).
`updatedAt`	`date-time`	Có	Dấu thời gian cập nhật lần cuối; có thể không thay đổi đối với các bản cập nhật nhỏ.

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

Các levelsbộ sưu tập , products, rolesvà 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 lộ trình học tập. Cả bốn bộ sưu tập đều có hình dạng giống nhau:

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

Các giá id trị sẽ khớp với các giá trị cho cấp độ, sản phẩm, vai trò và chủ đề có trong các mục danh mục khác. Liên kết name cung cấp một tên riêng bằng tiếng Anh cho mục nhập. Mảng này children là tùy chọn và cho phép phân cấp cho các giá trị có mối quan hệ con, chẳng hạn 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"
        },
        ...
    ]
}

Dưới đây là một bộ sản phẩm ví dụ, bao gồm các sản phẩm con để cung cấp một 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"
        },
        ...
    ]
}

Các bước tiếp theo

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

Last updated on 2026-02-11

Tìm hiểu tài liệu tham khảo dành cho nhà phát triển API nền tảng

Điểm cuối API

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

Xác thực

Quyền truy cập chỉ ứng dụng

Quyền truy cập được ủy quyền

Tham số truy vấn

Phản hồi API

Nội dung phản hồi

Phản hồi mô-đun

Thông tin chi tiết về tài sản

Hồ sơ đơn vị

Thông tin chi tiết về tài sản

Bản ghi lộ trình học tập

Thông tin chi tiết về tài sản

Hồ sơ Kỹ năng Ứng dụng

Thông tin chi tiết về tài sản

Hồ sơ chứng nhận

Thông tin chi tiết về tài sản

Hồ sơ thi

Thông tin chi tiết về tài sản

Hồ sơ khóa học do người hướng dẫn

Thông tin chi tiết về tài sản

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

Các bước tiếp theo

Tài nguyên bổ sung