Microsoft Learn 카탈로그 API 자주 묻는 질문
이 문서에서는 Microsoft Learn 카탈로그 API에 대한 자주 묻는 질문과 이에 대한 답변 및 필요에 따라 추가 정보에 대한 링크를 제공합니다.
일반
Q: Learn 카탈로그 API 사용 금액은 얼마인가요?
Learn 카탈로그 API는 사용 비용이 없습니다. 자세한 내용은 Learn Catalog API 기능 개요 문서의 가용성 및 가격 책정 섹션을 참조하세요.
Q: Learn 카탈로그 API를 사용 규칙은 무엇인가요?
Microsoft Learn과 Microsoft API 사용 약관을 참조하세요.
Q: Learn 카탈로그 API를 사용하기 위해 온보딩하거나 키를 가져와야 하나요?
아니요. API는 공개적으로 사용할 수 있습니다. cURL 및 Visual Studio Code를 사용한 Learn 카탈로그 API 문서 및/또는 Learn 카탈로그 API 개발자 참조 문서를 참조하세요.
Q: 이 API를 통해 사용자가 플랫폼 내에서 Learn 콘텐츠를 사용할 수 있나요?
아니요. Learn 카탈로그 API는 콘텐츠에 대한 메타데이터와 콘텐츠에 대한 직접 링크를 제공합니다. 사용자는 Microsoft API 사용 약관에 따라 이러한 링크를 LMS(학습 관리 시스템) 또는 웹 환경에 통합할 수 있습니다.
Q: Catalog API에서 반환된 데이터는 고정적으로 유지되나요 또는 변경되나요?
데이터는 새 콘텐츠가 추가, 수정, 삭제될 때마다 변경되며, 일반적으로 매일 적용됩니다.
API 응답
Q: 모든 데이터를 한 번에 사용할 수 있나요?
예. 기본 엔드포인트, learn.microsoft.com/api/catalog를 사용하여 전체 응답을 가져옵니다. 자세한 API 요청 정보는 Learn 카탈로그 API 개발자 참조 문서를 확인하세요.
Q: 응답을 미리 필터링할 수 있나요?
예. Learn 카탈로그 API 개발자 참조 문서에서 사용할 수 있는 쿼리 필터를 참조하세요.
Q: 각 콘텐츠 개체에 대해 UID가 고유하나요?
예. UID는 “고유 ID”를 의미하며 각 콘텐츠 개체는 고유합니다. UID가 변경되면 제목이나 다른 메타데이터가 동일하게 유지되더라도 콘텐츠는 새 개체로 간주됩니다.
Q: 모듈 요약에 HTML 태그가 있는 이유는 무엇인가요?
대개 요약의 서식을 최대한 원시 형식으로 유지하려고 하지만 특정 텍스트를 강조하거나 링크로 연결해야 하는 경우도 있습니다.
Q: 개별 단원의 링크가 없는 이유는 무엇인가요?
단원은 독립 실행형 콘텐츠로 작성되지 않습니다. 모듈에서 특정 순서로 수강할 수 있습니다. 이러한 이유로 모듈 세부 정보 페이지의 링크와 첫 번째 단원을 포함하여 사용자가 해당 위치에서 시작하고 콘텐츠를 진행할 수 있도록 했습니다.
Q: 어떤 콘텐츠가 새로운 것인지 어떻게 구분하나요?
last_modified 값은 레코드가 마지막으로 수정된 시기를 알려줍니다.
Q: 콘텐츠 링크에 대해 SSO(Single Sign-On)를 사용하도록 설정되어 있나요?
지금은 없습니다. 향후 SSO를 사용하도록 설정할 것입니다.
콘텐츠
Q: UID는 콘텐츠에 고유한가요?
예. UID는 “고유 ID”를 의미하며 각 콘텐츠 개체는 고유합니다. UID가 변경되면 제목이나 다른 메타데이터가 동일하게 유지되더라도 콘텐츠는 새 개체로 간주됩니다.
Q: 모든 모듈이 학습 경로에 속하나요?
아니요. 모듈은 자체 내에서 시나리오 또는 개념을 포괄적으로 가르치고 필수 모듈을 수강할 필요가 없다는 점에서 모두 독립 실행형입니다. 일부 모듈의 경우 이와 같으며 학습 경로에 속하지 않습니다. 다른 모듈에서는 사용자가 고급 개념을 파악하도록 안내하는 하나 이상의 학습 경로에 함께 번들로 제공됩니다. 모듈은 학습 경로의 일부일 필요는 없으며, 하나 이상의 일부일 수 있습니다.
Q: 콘텐츠가 추가, 새로 고침, 삭제된 시기를 알 수 있나요?
새 콘텐츠 개체가 추가되면 응답에서 새 개체(UID로 식별됨)로 나타납니다. 콘텐츠가 수정되면 해당 last_modified 값에 따라 알 수 있습니다. 콘텐츠가 삭제되면 콘텐츠 개체가 응답에서 제거됩니다. API 응답에서 콘텐츠가 업데이트되는 데 약간의 지연이 발생하는 경우가 있지만, 사용자가 콘텐츠의 URL을 따라가면 항상 최신 정보를 볼 수 있습니다. 콘텐츠가 삭제되는 경우 이전 URL은 새로운 콘텐츠나 환경 또는 차선책으로 리디렉션됩니다.
특히 콘텐츠는 항상 업데이트되고 있습니다. 하루에 두 번 사용 가능한 업데이트를 게시합니다. 사소한 텍스트 변경처럼 사소한 내용이거나 주요 내용을 수정, 추가, 삭제와 같은 주요 업데이트일 수 있습니다. 일반적으로 콘텐츠 포트폴리오는 관련 업무를 담당하는 사람만 수천 명이며 규모도 크고 고도로 관리되는 오픈 소스 프로젝트로 관리하여 항상 업데이트가 진행 중입니다. 프로덕션 시스템에서 Learn 카탈로그 API를 사용하는 경우 이를 인식하고 시스템에서 처리할 수 있어야 합니다.
Q: 책갈피를 꽂은 콘텐츠 링크를 따라갔는데 예상했던 것과 다른 콘텐츠가 표시되고 있습니다. 이유는 무엇입니까?
사이트 링크가 막다른 골목(404)에 도달하는 일이 없도록 최선을 다하고 있습니다. 콘텐츠가 수정되거나 교체되면 이전 링크에 대한 리디렉션을 구현하여 자동으로 새 콘텐츠로 이동합니다. 여러 가지 이유로 콘텐츠가 더 이상 사용되지 않고 대체되지 않는 경우, 범위를 약간 수정하거나 방문 페이지 등으로 적절한 차선의 콘텐츠로 리디렉션됩니다.
Q: 설명서, 비디오, 코드 샘플 카탈로그에 어떻게 액세스하나요?
현재 이러한 카탈로그에 액세스할 수 있는 프로그래밍 방식은 없습니다. 향후 이러한 카탈로그에 프로그래밍 방식으로 액세스할 예정입니다.
지역화
Q: Microsoft Learn에서 사용할 수 있는 언어는 무엇인가요?
Microsoft Learn에서는 65개 이상의 로캘을 사용할 수 있습니다. 사이트 바닥글을 통해 전체 목록을 볼 수 있습니다(전체 목록을 보려면 보고 있는 언어 선택).
Q: 다른 언어로 콘텐츠를 사용할 수 있나요?
경우에 따라 다릅니다. 콘텐츠에서 가르치는 제품이 제공되는 모든 언어로 콘텐츠를 제공하는 것을 목표로 합니다. 학습자가 지정된 로캘에서 Microsoft Learn 사이트를 방문할 때 해당 로캘에서 콘텐츠를 사용할 수 없는 경우 사용자는 원하는 로캘에서 머리글과 바닥글을 볼 수 있으며, 현지화된 버전이 제공될 때까지 핵심 콘텐츠는 영어로 기본 설정됩니다.
Q: 콘텐츠를 보는 언어에 따라 지정된 콘텐츠 개체의 콘텐츠가 다른가요?
그럴 수 있습니다. 업데이트가 영어 콘텐츠로 게시되면 지역화 파이프라인이 작동하여 지역화된 버전을 가능한 한 빨리 업데이트하며, 일반적으로 며칠 이내에 업데이트됩니다.
기타
Q: 조회수, 클릭수, 학습 완료와 같은 데이터를 얻기 위한 보고 API나 기능이 있나요?
현재 보고 API가 없습니다. 조직에서 사용자의 학습 완료를 보고할 수 있도록 하는 조직 보고 기능은 있습니다.
다음 단계
Learn 카탈로그 API에 대한 자세한 내용은 다음 링크를 참조하세요.