Microsoft Learn 카탈로그 API 개발자 참조 설명서
이 문서에서는 Microsoft Learn 카탈로그 API를 구현하는 개발자 및 요청자를 위한 정보를 제공합니다. 또한 Learn 카탈로그 API 모범 사례, 릴리스 정보 및 자주 묻는 질문 문서를 확인하여 개발 과정을 지원하는 것이 좋습니다.
API 엔드포인트
Microsoft Learn 카탈로그 API는 JSON 인코딩 응답을 반환하는 REST 기반 웹 API입니다. 전체 카탈로그를 요청하려면 GET 요청을 다음으로 보냅니다.
https://learn.microsoft.com/api/catalog/
참고
위에 나열된 엔드포인트는 현재의 엔드포인트입니다. 다른 이전 엔드포인트를 사용하는 경우 온보딩할 때 예상대로 작동하지만 새 엔드포인트로 전환하면 추가 쿼리 매개 변수와 같은 향상된 기능을 제공할 수 있다는 이점이 있습니다.
쿼리 매개 변수
다음은 요청이 포함될 수 있는 쿼리 매개 변수입니다. 모두 선택 사항입니다. 쿼리 매개 변수 값을 URL로 인코딩해야 합니다. 이러한 매개 변수가 하나도 없거나, 하나, 일부 또는 모두 있는 엔드포인트를 사용할 수 있습니다.
중요
둘 이상을 사용하는 경우 AND 연산자를 사용하여 쿼리를 평가합니다.
| 이름 | 값 | 형식 | 필수 | 예제 |
|---|---|---|---|---|
| locale | 지원되는 로캘 목록에서 유효한 단일 로캘 코드 반환된 메타데이터는 요청된 로캘(사용 가능한 경우)로 표시됩니다. 이 매개 변수가 제공되지 않으면 en-us 응답이 반환됩니다. |
문자열 | 예 | ?locale=en-us |
| type | 반환 응답에서 현재 제공하는 최상위 콘텐츠 또는 분류 개체 중 하나 이상의 쉼표로 구분된 목록입니다. 지원되는 값은 modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects입니다. |
string | 예 | ?type=modules,learningPaths |
| uid | 사용 가능한 콘텐츠 형식에서 하나 이상의 uid(유효한 콘텐츠 고유 ID)의 쉼표로 구분된 목록입니다. 참고: uid는 대/소문자를 구분합니다. | 문자열 | 예 | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | 개체의 마지막 수정 날짜를 기준으로 필터링할 연산자 및 날짜/시간입니다. 연산자는 lt(보다 작음), lte(보다 작거나 같음), eq(같음), gt(보다 큼), gte(보다 크거나 같음)을 포함합니다. 이 매개 변수를 사용하는 경우 연산자는 지정하지 않으면 gte를 기본값으로 설정됩니다. |
문자열 | 예 | ?last_modified=gte 2022-01-01 |
| popularity | 개체의 인기도 값(0-1 범위)으로 필터링할 연산자 및 값입니다. 연산자는 lt(보다 작음), lte(보다 작거나 같음), eq(같음), gt(보다 큼), gte(보다 크거나 같음)을 포함합니다. 이 매개 변수를 사용하는 경우 연산자는 지정하지 않으면 gte를 기본값으로 설정됩니다. |
문자열 | 예 | ?popularity=gte 0.5 |
| 수준 | 현재 사용할 수 있는 수준 중 하나 이상의 쉼표로 구분된 목록입니다(전체 목록은 API 응답의 수준 개체에 있음). | 문자열 | 예 | ?level=beginner |
| 역할(role) | 현재 사용할 수 있는 역할 중 하나 이상의 쉼표로 구분된 목록입니다(전체 목록은 API 응답의 역할 개체에 있음). | 문자열 | 예 | ?role=developer |
| product | 현재 사용할 수 있는 역할 중 하나 이상의 쉼표로 구분된 목록입니다(전체 목록은 API 응답의 제품 개체에 있음). API는 제품 계층 구조를 지원하지 않으므로 쿼리에 포함하려는 목록에 모든 제품을 추가합니다. | 문자열 | No | ?product=azure |
| subject | 현재 사용할 수 있는 역할 중 하나 이상의 쉼표로 구분된 목록입니다(전체 목록은 API 응답의 주체 개체에 있음). API는 주체 계층 구조를 지원하지 않으므로 쿼리에 포함하려는 목록에 모든 주체를 추가합니다. | 문자열 | 예 | ?subject=cloud-computing |
샘플 쿼리
아래에 나열된 쿼리는 요청할 수 있는 항목과 요청을 구성하는 방법을 파악하는 데 도움이 되는 샘플입니다.
| Description | 쿼리 |
|---|---|
| Learn 카탈로그 API의 모든 항목 | https://learn.microsoft.com/api/catalog/ |
| 모든 스페인어 모듈 | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| 인기 점수가 0.9 이상인 모든 모듈 | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| 모든 초급 보안 교육과 인증 개체 | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| 인기 점수가 0.5를 초과하고 지난 한 달간 업데이트된 모든 고급 접근성 모듈 | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
API 응답
서비스는 다음과 같은 HTTP 상태 코드를 반환할 수 있습니다.
| 상태 코드 | Description |
|---|---|
| 200 | 성공. 응답의 본문은 JSON 인코딩 데이터를 포함합니다. |
| 400 | 쿼리 매개 변수 중 하나가 없거나 잘못되었습니다. |
| 404 | 서버에서 URL을 찾을 수 없습니다. |
| 500 | 예기치 않은 서버 오류입니다. |
| 503 | 서비스를 일시적으로 사용할 수 없습니다. |
성공적인 응답에는 아래와 같이 모든 모듈 및 학습 경로에 대한 세부 정보가 포함됩니다.
응답 본문
성공적인 응답 본문은 JSON으로 인코딩되고 12개 섹션이 있습니다.
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
각 배열에는 응답의 해당 섹션과 관련된 데이터를 포함하는 JSON 인코딩 개체가 하나 이상 있습니다.
modules: 게시된 모듈의 배열입니다.units: 게시된 단원의 배열입니다.learningPaths: 게시된 학습 경로의 배열입니다.appliedSkills: 게시된 적용된 기술의 배열입니다.mergedCertifications: 시험과 병합된 게시된 인증의 배열입니다.certifications: 게시된 인증의 배열입니다.exams: 게시된 시험의 배열입니다.courses: 게시된 강사 진행 교육 과정의 배열입니다.levels: 가능한 대상 그룹 수준의 배열입니다.products: 카탈로그에서 다루는 가능한 제품 및 서비스의 배열입니다.roles: 가능한 작업 역할의 배열입니다.subjects: 가능한 제목 태그의 배열입니다.
모듈 레코드
모듈 레코드
각 모듈 레코드의 양식은 다음과 같습니다.
{
"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
}
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
summary |
문자열 | 모듈에 대한 간단한 설명을 제공하는 문자열입니다. 값은 내부 텍스트가 요약이 되는 HTML 단락 태그로 표현됩니다. |
levels |
문자열 배열 | 이 모듈의 모든 측면을 이해하려면 역할 경험이 얼마나 필요한지 나타내는 이 모듈에 연결된 수준 목록입니다. 단원 세부 정보는 수준 레코드에서 참조할 수 있습니다. |
roles |
문자열 배열 | 이 모듈과 관련된 작업 역할의 목록입니다. |
products |
문자열 배열 | 이 모듈에서 다루는 관련 제품의 목록입니다. 제품 세부 정보는 제품 레코드에서 참조할 수 있습니다. |
subjects |
문자열 배열 | 이 학습 경로에서 다루는 관련 주제의 목록입니다. |
uid |
문자열 | 이 모듈의 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
type |
문자열 | 레코드의 형식입니다. 값은 항상 ‘module’이 됩니다. |
title |
문자열 | 요청된 로캘 또는 미국 영어(대체)로 된 모듈 제목입니다. |
duration_in_minutes |
정수 | 이 모듈을 완료하는 데 걸리는 평균 시간(분)입니다. |
rating |
object | 모듈을 평가한 사용자 수인 count와 평가 집계(1~5)인 average를 모두 포함합니다. |
popularity |
double | 모듈의 인기를 나타내는 0~1의 정규화된 값입니다. |
icon_url |
문자열 | 투명한 배경의 모듈 목표 달성 이미지를 나타내는 100x100 SVG 이미지의 정규화된 URL입니다. |
social_image_url |
string | 소셜 미디어 또는 타일 경험에 적합한 사각형 불투명 배경의 모듈 목표 달성 이미지를 나타내는 PNG 이미지의 정규화된 URL입니다. 이 속성은 이 모듈에 사용할 수 없는 경우 응답에서 반환되지 않습니다. |
locale |
문자열 | 이 JSON 데이터가 작성된 언어입니다. 이 값은 요청된 로캘(사용 가능한 경우)이며, 요청된 로캘을 사용할 수 없는 경우 ‘en-us’입니다. |
last_modified |
날짜 | 마지막으로 이 모듈에 대해 주요 수정이 이루어진 시간입니다. |
url |
문자열 | 요청된 로캘로 된 Learn 모듈에 대한 정규화된 URL입니다. |
firstUnitUrl |
문자열 | 요청된 로캘로 된 Learn 모듈 첫 번째 단원에 대한 정규화된 URL입니다. |
units |
문자열 배열 | 연결된 단원 UID의 목록입니다. 단원 세부 정보는 단원 레코드에서 참조할 수 있습니다. |
number_of_children |
정수 | 이 모듈에 포함된 페이지(단원) 수입니다. |
단원 레코드
각 단원 레코드의 양식은 다음과 같습니다.
{
"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"
},
참고
단원은 독립 실행형 콘텐츠로 작성되지 않으므로 단원 레코드에 연결된 URL이 없습니다. 모듈에서 특정 순서로 수강할 수 있습니다. 이러한 이유로 모듈 세부 정보 페이지의 링크와 모듈 레코드의 첫 번째 단원을 포함하여 사용자가 해당 위치에서 시작하고 콘텐츠를 진행할 수 있도록 했습니다. 그러나 단원 레코드를 사용하여 LMS 또는 기타 환경에서 표시할 단원 세부 정보를 가져올 수 있습니다.
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
uid |
문자열 | 이 모듈의 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
type |
문자열 | 레코드의 형식입니다. 값은 항상 ‘unit’이 됩니다. |
title |
string | 요청된 로캘 또는 미국 영어(대체)로 된 단원 제목입니다. |
duration_in_minutes |
단원 기간입니다. 각 모듈에 연결된 단원의 모든 duration_in_minutes를 추가하면 총 모듈 시간을 얻게 됩니다. | |
locale |
문자열 | 이 JSON 데이터가 작성된 언어입니다. 이 값은 요청된 로캘(사용 가능한 경우)이며, 요청된 로캘을 사용할 수 없는 경우 ‘en-us’입니다. |
last_modified |
날짜 | 마지막으로 이 모듈에 대해 주요 수정이 이루어진 시간입니다. |
학습 경로 레코드
각 학습 경로 레코드의 양식은 다음과 같습니다.
{
"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
}
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
summary |
문자열 | 학습 경로에 대한 간단한 설명을 제공하는 문자열입니다. 값은 내부 텍스트가 요약이 되는 HTML 단락 태그로 표현됩니다. |
levels |
문자열 배열 | 이 학습 경로의 모든 측면을 이해하기 위해 역할에 대한 경험이 얼마나 필요한지 나타내는 이 학습 경로에 연결된 수준 목록입니다. 단원 세부 정보는 수준 레코드에서 참조할 수 있습니다. |
roles |
문자열 배열 | 이 학습 경로의 관련 작업 역할 목록입니다. |
products |
문자열 배열 | 이 학습 경로에서 다루는 관련 제품의 목록입니다. 제품 세부 정보는 제품 레코드에서 참조할 수 있습니다. |
subjects |
문자열 배열 | 이 학습 경로에서 다루는 관련 주제의 목록입니다. |
uid |
문자열 | 이 학습 경로의 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
type |
문자열 | 레코드의 형식입니다. 값은 항상 ‘learningPath’가 됩니다. |
title |
문자열 | 요청된 로캘 또는 미국 영어(대체)로 된 학습 경로 제목입니다. |
duration_in_minutes |
정수 | 이 학습 경로를 완료하는 데 걸리는 평균 시간(분)입니다. 이 값은 포함된 모든 모듈의 데이터 합계입니다. |
rating |
object | 학습 경로를 평가한 사용자 수인 count와 평가 집계(1~5)인 average를 모두 포함합니다. |
popularity |
double | 학습 경로의 인기를 나타내는 0~1의 정규화된 값입니다. |
icon_url |
문자열 | 학습 경로를 나타내는 100x100 SVG 이미지의 정규화된 URL입니다. |
social_image_url |
string | 소셜 미디어 또는 타일 환경에 적합한 사각형 불투명 배경의 학습 경로 목표 달성 이미지를 나타내는 PNG 이미지의 정규화된 URL입니다. 이 속성은 이 모듈에 사용할 수 없는 경우 응답에서 반환되지 않습니다. |
locale |
문자열 | 이 JSON 데이터가 작성된 언어입니다. 이 값은 요청된 로캘(사용 가능한 경우)이며, 요청된 로캘을 사용할 수 없는 경우 ‘en-us’입니다. |
last_modified |
날짜 | 이 학습 경로가 마지막으로 변경된 시간입니다. |
url |
문자열 | 요청된 로캘로 된 Microsoft Learn의 학습 경로에 대한 정규화된 URL입니다. |
firstModuleUrl |
문자열 | 요청된 로캘로 된 Microsoft Learn의 학습 경로 첫 번째 모듈에 대한 정규화된 URL입니다. |
modules |
문자열 배열 | 연결된 모듈 UID의 목록입니다. 모듈에 대한 세부 정보는 모듈 레코드에서 참조할 수 있습니다. |
number_of_children |
정수 | 이 학습 경로에 포함된 모듈 수입니다. |
적용된 기술 레코드
각 적용된 기술 레코드의 형식은 다음과 같습니다.
{
"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"
}
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
uid |
string | 이 적용된 기술에 대한 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
locale |
string | 이 JSON 데이터가 작성된 언어입니다. 이 값은 요청된 로캘(사용 가능한 경우)이며, 요청된 로캘을 사용할 수 없는 경우 ‘en-us’입니다. |
title |
string | 요청된 로캘의 적용된 기술 제목 또는 대체(fallback)로 사용되는 미국 영어입니다. |
summary |
string | 요청된 로캘의 적용된 기술 요약 또는 대체(fallback)로 사용되는 미국 영어입니다. |
url |
string | 요청된 로캘에서 Microsoft Learn의 적용된 기술로 연결되는 정규화된 URL입니다. |
icon_url |
string | 적용된 기술을 나타내는 100x100 SVG 이미지로 연결되는 정규화된 URL입니다(사용 가능한 경우, 포함되지 않음). |
levels |
문자열 배열 | 이 적용된 기술과 연결된 수준 목록입니다. |
roles |
문자열 배열 | 이 적용된 기술의 관련 작업 역할 목록입니다. 역할 세부 정보는 역할 레코드에서 참조할 수 있습니다. |
subjects |
문자열 배열 | 이 적용된 기술에서 다루는 관련 주제 목록입니다. |
study_guide |
개체 배열 | 이 적용된 기술에 대해 연구할 관련 콘텐츠 목록입니다. 개체 세부 정보는 연결된 레코드에서 참조할 수 있습니다. |
last_modified |
날짜 | 이 적용된 기술이 마지막으로 변경된 시간입니다. |
병합된 인증 레코드
병합된 각 인증 레코드의 형식은 다음과 같습니다.
{
"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": []
}
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
uid |
문자열 | 이 인증의 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
title |
string | 요청된 로캘 또는 미국 영어(대체)로 된 인증 제목입니다. |
summary |
string | 요청된 로캘의 인증 요약 또는 대체(fallback)로 사용되는 미국 영어입니다. |
url |
string | 요청된 로캘로 된 Microsoft Learn 인증의 정규화된 URL입니다. |
icon_url |
string | 인증을 나타내는 100x100 SVG 이미지의 정규화된 URL입니다. |
last_modified |
날짜 | 이 인증이 마지막으로 변경된 시간입니다. |
type |
string | 레코드의 형식입니다. 값은 항상 ‘cert’가 됩니다. |
certification_type |
string | 인증 형식입니다. 가능한 값은 ‘fundamentals’, ‘mce’, ‘mcsa’, ‘mcsd’, ‘mcse’, ‘mos’, ‘mta’, ‘role-based’, ‘specialty’입니다. |
products |
문자열 배열 | 이 인증에서 다루는 관련 제품 목록입니다. 제품 세부 정보는 제품 레코드에서 참조할 수 있습니다. |
levels |
문자열 배열 | 이 인증의 시험에 대한 모든 측면을 이해하기 위해 역할에 대한 경험이 얼마나 필요한지 나타내는 이 인증에 연결된 수준 목록입니다. 단원 세부 정보는 수준 레코드에서 참조할 수 있습니다. |
roles |
문자열 배열 | 이 인증의 관련 작업 역할 목록입니다. 역할 세부 정보는 역할 레코드에서 참조할 수 있습니다. |
subjects |
문자열 배열 | 이 인증에서 다루는 관련 주체 목록입니다. |
renewal_frequency_in_days |
정수 | 이 인증이 만료되어 갱신해야 하기 전의 일 수입니다. 값이 0이면 인증이 만료되지 않습니다. |
prerequisites |
문자열 배열 | 이 인증을 획득하기 위한 권장 필수 구성 요소 목록입니다. 인증에 대한 세부 정보는 인증 레코드에서 참조할 수 있습니다. |
skills |
문자열 배열 | 이 인증에 필요한 시험에서 측정하는 기술의 목록입니다. |
recommendation_list |
문자열 배열 | 이 인증과 관련된 권장 사항 목록입니다. |
study_guide |
개체의 배열 | 이 인증을 위해 연구할 연결된 콘텐츠의 목록입니다. 개체 세부 정보는 연결된 레코드에서 참조할 수 있습니다. |
exam_duration_in_minutes |
정수 | 시험을 완료하기 위해 할당된 시간(분)입니다. |
locales |
문자열 배열 | 이 인증이 제공되는 언어 목록입니다. |
providers |
개체 배열 | 이 인증의 공급자 목록입니다. 형식은 공급자 및 공급자를 사용하여 시험을 예약할 수 있는 링크가 있는 정규화된 URL을 설명합니다. |
career_paths |
개체의 배열 | 이 인증의 경력 경로 목록입니다. |
참고 항목
하나의 시험만 필요한 인증은 이 mergedCertifications 속성의 일부로 반환됩니다.
인증 레코드
각 인증 레코드의 양식은 다음과 같습니다.
{
"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"
}
]
}
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
uid |
문자열 | 이 인증의 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
title |
string | 요청된 로캘 또는 미국 영어(대체)로 된 인증 제목입니다. |
subtitle |
string | 요청된 로캘 또는 미국 영어(대체)로 된 인증 부제목입니다. |
url |
string | 요청된 로캘로 된 Microsoft Learn 인증의 정규화된 URL입니다. |
icon_url |
string | 인증을 나타내는 100x100 SVG 이미지의 정규화된 URL입니다. |
type |
문자열 | 레코드의 형식입니다. 값은 항상 ‘cert’가 됩니다. |
certification_type |
string | 인증 형식입니다. 가능한 값은 ‘fundamentals’, ‘mce’, ‘mcsa’, ‘mcsd’, ‘mcse’, ‘mos’, ‘mta’, ‘role-based’, ‘specialty’입니다. |
exams |
문자열 배열 | 이 인증에 필요한 연결된 시험의 목록입니다. 단원 세부 정보는 인증 레코드에서 참조할 수 있습니다. |
levels |
문자열 배열 | 이 인증의 시험에 대한 모든 측면을 이해하기 위해 역할에 대한 경험이 얼마나 필요한지 나타내는 이 인증에 연결된 수준 목록입니다. 단원 세부 정보는 수준 레코드에서 참조할 수 있습니다. |
roles |
문자열 배열 | 이 인증의 관련 작업 역할 목록입니다. 역할 세부 정보는 역할 레코드에서 참조할 수 있습니다. |
study_guide |
개체의 배열 | 이 인증을 위해 연구할 연결된 콘텐츠의 목록입니다. 개체 세부 정보는 연결된 레코드에서 참조할 수 있습니다. |
참고 항목
둘 이상의 시험이 필요한 인증은 시험 배열을 참조하는 이 인증 레코드에 표시됩니다.
시험 레코드
각 시험 레코드의 양식은 다음과 같습니다.
{
"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&utm_medium=certpage&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"
}
]
}
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
uid |
문자열 | 이 시험의 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
title |
string | 요청된 로캘 또는 미국 영어(대체)로 된 시험 제목입니다. |
subtitle |
string | 요청된 로캘 또는 미국 영어(대체)로 된 시험 부제목입니다. |
display_name |
string | 요청된 로캘 또는 미국 영어(대체)로 된 시험 표시 이름입니다. |
url |
string | 요청된 로캘로 된 Microsoft Learn 시험의 정규화된 URL입니다. |
icon_url |
string | 시험을 나타내는 100x100 SVG 이미지의 정규화된 URL입니다. |
pdf_download_url |
string | 이 시험으로 측정된 기술을 간략하게 소개하는 PDF의 정규화된 URL입니다. |
practice_test_url |
string | 시험에 연결된 연습 테스트에 대한 정규화된 URL입니다. |
practice_assessment_url |
문자열 | 시험에 연결된 무료 연습 평가의 정규화된 URL입니다. |
locales |
문자열 배열 | 이 시험이 제공되는 언어 목록입니다. |
type |
문자열 | 레코드의 형식입니다. 값은 항상 ‘exam’이 됩니다. |
courses |
문자열 배열 | 연결된 과정 UID의 목록입니다. 과정 세부 정보는 과정 레코드에서 참조할 수 있습니다. |
levels |
문자열 배열 | 이 시험에 대한 모든 측면을 이해하기 위해 역할에 대한 경험이 얼마나 필요한지 나타내는 이 시험에 연결된 수준 목록입니다. 단원 세부 정보는 수준 레코드에서 참조할 수 있습니다. |
roles |
문자열 배열 | 이 시험의 관련 작업 역할 목록입니다. 역할 세부 정보는 역할 레코드에서 참조할 수 있습니다. |
products |
문자열 배열 | 이 시험에서 다루는 관련 제품의 목록입니다. 제품 세부 정보는 제품 레코드에서 참조할 수 있습니다. |
providers |
개체의 배열 | 이 시험의 공급자 목록입니다. 형식은 공급자 및 공급자를 사용하여 시험을 예약할 수 있는 링크가 있는 정규화된 URL을 설명합니다. |
study_guide |
개체의 배열 | 이 시험에 대한 연구에 연결된 콘텐츠 목록입니다. 개체 세부 정보는 연결된 레코드에서 참조할 수 있습니다. |
강사 주도 과정 레코드
각 과정 레코드의 양식은 다음과 같습니다.
{
"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"
}
]
},
필드 세부 정보
| 필드 | 형식 | Description |
|---|---|---|
uid |
문자열 | 이 강사 주도 과정에 대한 고유 식별자입니다. 이 값은 모든 MS Learn에서 고유합니다. |
course_number |
string | 강사 주도 과정의 번호 식별자입니다. |
title |
string | 요청된 로캘 또는 미국 영어(대체)로 된 강사 주도 과정의 제목입니다. |
summary |
string | 강사 주도에 관해 간단하게 설명하는 문자열입니다. 값은 내부 텍스트가 요약이 되는 HTML 단락 태그로 표현됩니다. |
duration_in_hours |
정수 | 이 강사 주도 과정을 완료하는 데 걸리는 평균 시간입니다. |
url |
string | 요청된 로캘로 된 Microsoft Learn에서 강사 주도 과정 세부 정보 페이지의 정규화된 URL입니다. |
icon_url |
string | 강사 주도 과정의 목표 달성을 나타내는 100x100 SVG 이미지의 정규화된 URL입니다. |
locales |
문자열 배열 | 이 강사 주도 과정이 공식적으로 제공되는 언어 목록입니다. 학습 파트너가 다른 언어를 지원할 수 있습니다. |
type |
문자열 | 레코드의 형식입니다. 강사 주도 과정의 경우 값은 항상 ‘course’입니다. |
certification |
string | 강사 주도 과정과 연결된 인증입니다. |
exam |
string | 강사 주도 과정과 연결된 시험입니다. |
levels |
문자열 배열 | 이 과정에 대한 모든 측면을 이해하기 위해 역할 경험이 얼마나 필요한지 나타내는 이 강사 주도 과정에 연결된 수준 목록입니다. 단원 세부 정보는 수준 레코드에서 참조할 수 있습니다. |
study_guide |
개체의 배열 | 이 인증으로 측정된 기술을 요약한 PDF의 정규화된 URL입니다. |
수준, 제품, 역할 및 주제 레코드
levels, products, roles 및 subjects 컬렉션은 모듈 및 학습 경로 데이터에 사용되는 값의 이름을 제공합니다. 네 컬렉션의 셰이프는 모두 같습니다.
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
id는 다른 카탈로그 항목에 포함된 수준, 제품, 역할 및 주제의 값과 일치합니다. 연결된 name은 항목의 적절한 이름(영어)을 제공합니다. children 배열은 선택 사항이며, 제품 같은 자식 관계가 있는 값의 계층 구조를 구현할 수 있습니다.
다음은 가능한 역할 집합의 예입니다.
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
다음은 더 구체적인 제품 범주를 제공하기 위해 포함된 자식이 있는 제품 집합의 예입니다.
{
...
"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"
},
...
]
}
코드 샘플
Learn 카탈로그 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);
}
cURL 확장을 사용하는 PHP
<?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;
?>
‘requests’ 라이브러리를 사용하는 PYTHON 3
#!/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)
다음 단계
개발 경험에 도움이 되도록 아래 리소스를 검토합니다.