다음을 통해 공유

curl 및 Visual Studio Code를 사용하여 Microsoft Learn 카탈로그 API 시작

이 문서는 curl 및 Visual Studio Code와 함께 Microsoft Learn 카탈로그 API 사용을 시작하는 데 도움이 됩니다. API 또는 API의 사용 사례에 대해 잘 모르는 경우 먼저 Learn Catalog API 기능 개요 문서를 검토하는 것이 좋습니다.

살펴볼 개략적인 프로세스는 다음과 같습니다.

  1. Learn Catalog API를 쿼리하다.
  2. 초기 응답 검토
  3. 응답 "Prettify"
  4. 스프레드시트로 변환
  5. 더 많은 쿼리 사용해 보기

사용자 고유의 요구에 맞게 Learn Catalog API를 사용하기 시작하면 원하는 도구 집합 또는 요구 사항에 따라 이러한 단계를 약간 수정할 수 있지만 일반적으로 이 API를 사용하는 프로세스는 모든 사용 사례에서 동일합니다.

필수 조건

이 문서의 단계를 따르려면 API를 쿼리하기 위해 인기 있는 두 가지 무료 도구인 curl 및 Visual Studio Code가 필요합니다.

  • curl 및 Visual Studio Code가 이미 설치된 경우 학습 카탈로그 API 쿼리 섹션으로 건너뛸 수 있습니다.
  • 설치되어 있지 않은 경우 다음 섹션의 지침을 따릅니다.

curl 다운로드 및 설정

curl 은 API를 쿼리할 수 있는 인기 있는 무료 오픈 소스 명령줄 도구입니다.

  1. curl 다운로드 페이지로 이동하여 환경에 적용 가능한 패키지를 다운로드합니다.
  2. 애플리케이션을 설치하고 프롬프트에 따라 구성합니다. 이 문서나 Learn 카탈로그 API 쿼리에는 고유한 설정이 필요하지 않습니다.

Visual Studio Code 다운로드 및 설정

Visual Studio Code 는 Microsoft에서 만든 무료 강력한 코드 편집기입니다.

  1. Visual Studio Code 사이트로 이동하여 환경에 적용 가능한 패키지를 다운로드합니다.
  2. 애플리케이션을 설치하고 프롬프트에 따라 구성합니다.

Learn Catalog API를 쿼리하다.

Learn Catalog API를 사용하는 데 필요한 인증이 없으므로 curl 사용이 가능한 명령줄에서 API 엔드포인트를 쿼리할 수 있습니다. 이 연습에서는 Visual Studio Code 내에서 터미널을 사용합니다.

  1. Visual Studio Code를 엽니다.
  2. 위쪽 탐색에서 터미널을 선택합니다.
  3. 새 터미널을 선택하여 새 명령 터미널을 엽니다.
  4. 선택한 터미널(Bash, CMD 등)을 선택하고 아래 명령을 입력합니다. 아래 명령은 curl을 사용하고 필터링되지 않은 Learn Catalog API 엔드포인트를 호출하고 터미널에 표시된 파일 경로에 정의된 위치에 "output.json"라는 파일에 응답을 출력한다는 것을 나타냅니다(예: C:\Users\<username>).
curl https://learn.microsoft.com/api/catalog >> output.json
  1. 요청이 성공한 경우 파일의 총 크기(예: 13.1M)에 대한 정보가 표시됩니다(응답 크기에 따라 크기가 변경될 수 있음). 실패하면 오류가 발생할 것입니다.

비고

output.json 파일을 사용한 후 삭제하거나 더 적용 가능하도록 이름을 바꿔야 합니다. 동일한 파일 이름을 사용하여 API를 다시 쿼리하면 기존 파일 내에 응답이 추가됩니다. 또 다른 옵션은 "output-1212.json" 또는 "output-de-de-2022-12-12.json"와 같은 초기 쿼리 명령 중에 파일의 이름을 보다 고유하게 지정하는 것입니다.

초기 응답 검토

초기 응답은 JSON이며 "최소화"됩니다. 즉, 파일을 작게 만들기 위해 특정 공백, 선 및 탭이 제거됩니다.

  1. Visual Studio Code에서 파일을 선택합니다.
  2. 파일 열기를 선택합니다.
  3. 이전 섹션의 일부로 만든 "output.json" 파일로 이동합니다.

이 최소화는 표준 사례이며 다음 섹션에서 수행할 Visual Studio Code의 명령으로 파일을 더 읽기 쉽게 "미리"할 수 있습니다.

응답을 보기 좋게 만들기

  1. Visual Studio Code에서 "output.json" 파일을 연 상태에서 Ctrl+Shift+I를 사용합니다.

JSON은 여러 줄로 분할되고 더 읽기 쉬운 형식으로 업데이트되어야 합니다. 응답 내의 다양한 속성 및 값에 대한 자세한 내용은 데이터 사전에 대한 Learn Catalog API 개발자 참조 문서를 참조하세요.

응답을 스프레드시트로 변환

시스템에 통합하는 대신 개별 작업 또는 검토에 Learn Catalog API를 사용하는 사람들이 많습니다. 이러한 사용 사례의 경우 JSON 응답을 CSV 또는 Excel 형식으로 변환하여 스프레드시트로 보는 것이 유용할 수 있습니다. 원하는 변환 도구를 사용할 수 있지만 여기서는 Flatfile Json to CSV 변환기를 사용할 수 있습니다.

  1. https://csvjson.com/json2csv로 이동하세요.
  2. 출력 파일을 업로드합니다.
  3. 변환을 선택합니다.
  4. 다운로드를 선택합니다.

비고

외부 온라인 도구를 사용하여 데이터를 변환하고 어떤 데이터를 입력하는지 고려해야 합니다. Learn Catalog API의 경우 응답을 공개적으로 사용할 수 있으며 인증이 필요하지 않으므로 온라인 도구를 사용하여 형식을 변환하는 것이 좋습니다.

더 많은 쿼리 사용해 보기

위의 단계에 따라 아래에 나열된 쿼리와 같은 더 많은 쿼리를 시도합니다. 각각의 응답 파일 크기 변화와 개체 내의 차이를 확인합니다.

Description Query
Learn Catalog 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

다음 단계

개발 과정을 돕기 위해 아래 리소스를 검토하는 것이 좋습니다.

  • Last updated on