Condividi tramite

Introduzione all'API catalogo di Microsoft Learn con curl e Visual Studio Code

Questo articolo illustra come iniziare a usare l'API catalogo di Microsoft Learn con curl e Visual Studio Code. Se non si ha familiarità con i dettagli dell'API o dei casi d'uso, è consigliabile esaminare prima di tutto l'articolo panoramica delle funzionalità api del catalogo di Learn.

Il processo generale che verrà illustrato è:

  1. Eseguire query sull'API del catalogo di Learn
  2. Esaminare la risposta iniziale
  3. Abbellisci la risposta
  4. Convertirlo in un foglio di calcolo
  5. Prova altre query

Quando si inizia a usare l'API Del catalogo Di Learn per le proprie esigenze, è possibile modificare questi passaggi leggermente, per il set di strumenti o le esigenze desiderate, ma in genere il processo di utilizzo è lo stesso per tutti i casi d'uso.

Prerequisiti

Per seguire i passaggi descritti in questo articolo, sono necessari curl e Visual Studio Code, due strumenti gratuiti più diffusi per l'esecuzione di query sulle API.

  • Se curl e Visual Studio Code sono già installati, è possibile passare alla sezione Query sull'API del catalogo di Learn.
  • Se non sono installati, seguire le istruzioni riportate nelle sezioni seguenti.

Scaricare e configurare curl

curl è uno strumento da riga di comando comune, gratuito e open source in grado di eseguire query sulle API.

  1. Vai alla pagina di download curl e scarica il pacchetto applicabile per il tuo ambiente. Se non si è certi di quale selezionare, usare la procedura guidata di download di curl .
  2. Installare l'applicazione e seguire le istruzioni da configurare. Non sono necessarie impostazioni univoche per questo articolo o per l'esecuzione di query sull'API del catalogo di Learn.

Scaricare e configurare Visual Studio Code

visual Studio Code è un editor di codice gratuito e potente creato da Microsoft.

  1. Vai al sito web di Visual Studio Code e scarica il pacchetto adatto al tuo ambiente.
  2. Installare l'applicazione e seguire le istruzioni da configurare.

Eseguire query sull'API del catalogo di Learn

Poiché non è necessaria alcuna autenticazione per l'uso dell'API di Learn Catalog, è possibile eseguire query sull'endpoint API da qualsiasi riga di comando abilitata per curl. Per questo esercizio si userà il terminale in Visual Studio Code.

  1. Apri Visual Studio Code.
  2. Selezionare Terminale nella barra di spostamento superiore.
  3. Selezionare Nuovo terminale per aprire un nuovo terminale dei comandi.
  4. Selezionare il terminale preferito (Bash, CMD e così via) e digitare il comando seguente. Il comando seguente indica che vuole usare curl, chiamare l'endpoint dell'API Learn Catalog non filtrato e restituirà la risposta a un file denominato "output.json", nel percorso definito nel percorso file indicato nel terminale (ad esempio: C:\Users\<username>):
curl https://learn.microsoft.com/api/catalog >> output.json
  1. Se la richiesta ha esito positivo, verranno visualizzate informazioni sulle dimensioni totali del file, ad esempio 13,1 M (le dimensioni sono soggette a modifiche, a seconda delle dimensioni della risposta). In caso di esito negativo, dovrebbe essere visualizzato un errore.

Nota

È consigliabile eliminare il file di output.json dopo averlo usato o rinominarlo in modo che sia più applicabile. Se si esegue di nuovo una query sull'API usando lo stesso nome file, la risposta verrà aggiunta all'interno del file esistente. Un'altra opzione consiste nel denominare il file in modo più univoco durante il comando di query iniziale, ad esempio "output-1212.json" o "output-de-de-2022-12-12.json".

Esaminare la risposta iniziale

La risposta iniziale è in JSON e sarà "minimizzata", ovvero alcuni spazi, righe e tabulazioni vengono rimossi per ridurre il file.

  1. In Visual Studio Code selezionare File.
  2. Selezionare Apri file.
  3. Passare al file "output.json" creato come parte della sezione precedente.

Questa riduzione al minimo è una procedura standard e il file può essere "prettified" per essere più leggibile da un comando in Visual Studio Code, che verrà eseguito nella sezione successiva.

Abbellire la risposta

  1. Con il file "output.json" aperto in Visual Studio Code, usare CTRL+MAIUSC+I.

Il codice JSON deve essere aggiornato per suddividere in più righe e avere un formato più leggibile. Per informazioni sulle diverse proprietà e valori all'interno della risposta, vedere l'articolo di riferimento per sviluppatori dell'API di Learn Catalog per il dizionario dati.

Convertire la risposta in un foglio di calcolo

Esistono molte persone che usano l'API Learn Catalog per singole attività o verifiche, invece di integrarla in un sistema. Per questi casi d'uso, può essere utile convertire la risposta JSON in un formato CSV o Excel da visualizzare come foglio di calcolo. È possibile usare qualsiasi strumento di conversione preferito, ma in questo caso è possibile usare il convertitore Json flatfile al convertitore CSV.

  1. Passare a: https://csvjson.com/json2csv.
  2. Caricare il file di output.
  3. Selezionare Converti.
  4. Selezionare Scarica.

Nota

Prestare molta attenzione all'uso di strumenti online esterni per convertire i dati e prendere in considerazione i dati inseriti. Nel caso dell'API del catalogo di Learn, la risposta è disponibile pubblicamente e non richiede l'autenticazione, quindi è possibile usare uno strumento online per convertire il formato.

Prova altre query

Seguire i passaggi precedenti per provare altre query, ad esempio quelle elencate di seguito. Visualizzare il modo in cui le dimensioni del file di risposta cambiano per ogni oggetto e la differenza negli oggetti all'interno.

Descrizione Quesito
Tutti gli elementi nell'API Learn Catalog https://learn.microsoft.com/api/catalog/
Tutti i moduli spagnoli https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules
Tutti i moduli con un punteggio di popolarità pari o superiore a 0,9 https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9
Tutti gli oggetti di formazione e certificazione per la sicurezza per principianti https://learn.microsoft.com/api/catalog/?level=beginner&subject=security
Tutti i moduli di accessibilità avanzati con un punteggio di popolarità superiore a 0,5 e aggiornati nell'ultimo mese https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01

Passaggi successivi

È consigliabile esaminare le risorse seguenti per facilitare il percorso di sviluppo: