다음을 통해 공유


Microsoft Learn 카탈로그 API 기능 개요

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

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

  • 모듈
  • 단위
  • 학습 경로
  • 적용된 기술
  • 인증
  • 시험
  • 강사 주도 과정

참고 항목

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

사용 사례

  • Microsoft Learn 교육 및/또는 인증 제품에 대한 메타데이터 보기
  • 사용자 고유의 온라인 환경에서 연결하기 위해 Microsoft Learn 교육 및/또는 인증 제품 목록을 풀(pull)합니다.

Learn 카탈로그 API 작동 방식

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

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

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

Screenshot of the Learn Catalog API output in Visual Studio Code.

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

사용하고자 하면 cURL과 Visual Studio Code 문서를 사용하여 Microsoft Learn 카탈로그 API 시작하기를 확인하세요.

요구 사항

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

다음은 Learn 카탈로그 API를 사용하는 사용자를 볼 수 있는 몇 가지 방법입니다.

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

가용성 및 가격 책정

Microsoft Learn 카탈로그 API는 공개적으로 사용 가능하며 Microsoft API 사용 약관의 계약조건에 따라 제공됩니다. API는 사용 요금이 부과되지 않습니다.

제한 사항

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

다음 단계

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