다음을 통해 공유


Microsoft Learn 카탈로그 API 기능 개요

Microsoft Learn 카탈로그 API는 REST 기반 Web API로, Microsoft Learn에 웹 기반 쿼리를 보내고 타이틀, 제품, 수준, 교육 링크 및 기타 메타데이터와 같은 사용 가능한 교육 콘텐츠 및 인증 시험에 대한 세부 정보를 다시 가져오고 정보가 포함된 JSON 인코딩 응답을 반환할 수 있습니다.

공개적으로 사용할 수 있는 모든 정보에 대한 정보를 반환합니다.

  • 모듈
  • 단위
  • 학습 경로
  • 적용된 기술
  • 인증
  • 시험
  • Instructor-Led 과정

메모

최근 Microsoft Learn 사이트 업데이트의 일부로 learn.microsoft.com 도메인에서 사용할 수 있는 새 카탈로그 API 엔드포인트가 있습니다. 이전 엔드포인트는 여전히 예상대로 작동하지만 새 엔드포인트로 전환하면 추가 쿼리 매개 변수와 같은 향상된 기능을 제공할 수 있다는 이점이 있습니다.

사용 사례

  • Microsoft Learn 교육 및/또는 인증 제품에 대한 메타데이터 보기
  • Microsoft Learn 교육 및/또는 인증 제품 목록을 끌어오면 사용자 고유의 온라인 환경에서 연결할 수 있습니다.

Learn Catalog API 작동 방식

API는 JSON으로 인코딩된 응답을 반환하는 REST 기반 Web API입니다. 전체 카탈로그를 요청하려면 GET 요청을 다음으로 보냅니다.

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

출력은 아래 스크린샷과 유사합니다. 2022년 11월 현재 전체 응답은 약 13MB입니다.

Visual Studio Code의 Learn Catalog API 출력 스크린샷

각 학습 카탈로그 항목은 각각에 사용할 수 있는 메타데이터 집합이 있는 개체입니다. 전체 데이터 사전 및 기타 옵션은 microsoft Learn Catalog API 개발자 설명서 나열됩니다. 최신 업데이트를 확인할 수 있는 릴리스 정보(링크)와 모범 사례 정보를 또한 제공하고 있습니다.

사용하려는 경우 cURL 및 Visual Studio Code 문서 사용하여 Microsoft Learn 카탈로그 API 시작확인하세요.

요구 사항

Microsoft Learn 카탈로그 API에 액세스하는 데 필요한 인증은 없습니다. 사용자는 cURL, Postman 등과 같은 선호하는 API 요청 방법을 사용할 수 있습니다.

예제

다음은 Learn Catalog API를 사용하여 사용자에게 표시되는 몇 가지 방법입니다.

  • Viva Learning Learn 카탈로그 API를 사용하여 Microsoft Learn 카탈로그를 핵심 환경의 일부로 제공했습니다.
  • 조직 및 교육 기관은 Learn Catalog API를 사용하여 카탈로그 정보를 가져와서 LMS(내부 학습 관리 시스템)에 게시하므로 직원과 학생이 쉽게 액세스할 수 있습니다.
  • 학습 공급자는 Learn Catalog API를 사용하여 카탈로그 정보를 가져와 고객 학습 환경에 게시합니다.

가용성 및 가격 책정

Microsoft Learn 카탈로그 API는 공개적으로 사용할 수 있으며 Microsoft API 사용 약관따라 제공됩니다. API를 사용하는 데는 요금이 부과되지 않습니다.

제한

  • API에는 공개적으로 사용할 수 있는 모듈, 단위, 학습 경로, 강사 주도 과정, 시험 및 인증이 포함됩니다. 지금은 설명서, 코드 샘플, 쇼 또는 이벤트를 출력하지 않습니다.
  • API는 하루에 한 번 이상 새로 고칩니다.
  • API 버전에 대한 업데이트는 Learn Catalog API 릴리스 정보업데이트를 통해 전달됩니다.

다음 단계

Learn Catalog API에 대해 자세히 알아보려면 다음 문서를 검토하세요.