Jaa

Microsoft Learnin hakemiston ohjelmointirajapinnan käytön aloittaminen curlin ja Visual Studio Coden avulla

Tässä artikkelissa kerrotaan, miten voit aloittaa Microsoft Learnin hakemiston ohjelmointirajapinnan käytön curlin ja Visual Studio Coden avulla. Jos et tunne ohjelmointirajapinnan tietoja tai sen käyttötapauksia, suosittelemme, että tutustut ensin Learnin hakemiston ohjelmointirajapinnan yleiskatsausartikkeliin, joka ensin.

Korkean tason prosessi on seuraava:

  1. Kysely Learn-hakemiston ohjelmointirajapinnasta
  2. Tarkista ensimmäinen vastaus
  3. "Prettify" vastaus
  4. Sen muuntaminen laskentataulukoksi
  5. Kokeile lisää kyselyitä

Kun alat käyttää Learnin hakemiston ohjelmointirajapintaa omiin tarpeisiisi, saatat hieman muokata näitä vaiheita haluamasi työkaluvalikoiman tai tarpeiden mukaan, mutta yleensä käyttöprosessi on sama kaikissa käyttötapauksissa.

Edellytykset

Jotta voit noudattaa tämän artikkelin vaiheita, tarvitset curl-and Visual Studio Coden, kaksi suosittua, maksutonta työkalua ohjelmointirajapintojen kyselemiseen.

  • Jos curl ja Visual Studio Code ovat jo asennettuna, voit siirtyä Eteenpäin Kysely oppimaan hakemiston ohjelmointirajapintaan -osioon.
  • Jos niitä ei ole asennettu, noudata seuraavissa osioissa annettuja ohjeita.

Lataa ja määritä kihara

curl on suosittu, ilmainen, avoimen lähdekoodin komentorivityökalu, joka voi tehdä kyselyjä ohjelmointirajapinnoista.

  1. Siirry curl Download Page - ja lataa ympäristöösi soveltuva paketti.
  2. Asenna sovellus ja määritä se noudattamalla kehotteita. Tähän artikkeliin tai Learnin hakemiston ohjelmointirajapinnan kyselyyn ei tarvita yksilöllisiä asetuksia.

Visual Studio Coden lataaminen ja määrittäminen

Visual Studio Code on Microsoftin luoma maksuton ja tehokas koodieditori.

  1. Siirry Visual Studio Code -sivustoon ja lataa ympäristöösi soveltuva paketti.
  2. Asenna sovellus ja määritä se noudattamalla kehotteita.

Kysely Learn-hakemiston ohjelmointirajapinnasta

Koska Learnin hakemiston ohjelmointirajapinnan käyttämiseen ei tarvita todennusta, voit tehdä kyselyn ohjelmointirajapinnan päätepisteeseen millä tahansa komentorivillä, jonka curl-ominaisuus on käytössä. Tässä harjoituksessa käytämme Visual Studio Coden päätetta.

  1. Avaa Visual Studio Code.
  2. Valitse yläreunan siirtymisruudusta Pääte.
  3. Avaa uusi komentopääte valitsemalla Uusi pääte.
  4. Valitse valintapääte (Bash, CMD jne.) ja kirjoita alla oleva komento. Alla oleva komento ilmaisee, että se haluaa käyttää kiharaa, kutsua suodattamatonta Learn-hakemiston ohjelmointirajapinnan päätepistettä ja tulostaa vastauksen tiedostoon nimeltä "output.json", päätteessä näkyvässä tiedostopolusta määritetyssä sijainnissa (ex: C:\Users\<username>):
curl https://learn.microsoft.com/api/catalog >> output.json
  1. Jos pyyntö onnistui, sinun pitäisi nähdä tietoja tiedoston kokonaiskoosta, kuten 13,1 M (koko voi muuttua vastauksen koon mukaan). Jos se epäonnistui, sinun pitäisi saada virhe.

Muistiinpano

Poista output.json tiedosto, kun olet käyttänyt sitä, tai nimeä se uudelleen. Jos teet ohjelmointirajapinnasta kyselyn uudelleen käyttämällä samaa tiedostonimeä, se liittää vastauksen olemassa olevaan tiedostoon. Toinen vaihtoehto on nimetä tiedosto yksilöllisemmin ensimmäisen kyselykomennon aikana, esimerkiksi "output-1212.json" tai "output-de-de-2022-12-12.json".

Tarkista ensimmäinen vastaus

Ensimmäinen vastaus on JSON-muodossa ja se "pienennetään", mikä tarkoittaa, että tietyt välilyönnit, rivit ja välilehdet poistetaan tiedoston pienentämiseksi.

  1. Valitse Visual Studio Codessa Tiedosto.
  2. Valitse Avaa tiedosto.
  3. Siirry "output.json" -tiedostoon, joka luotiin osana edellistä osiota.

Tämä pienoissovellus on vakiokäytäntö, ja visual studio code -komennolla voit muokata tiedostoa luettavuuden helpottamiseksi. Tämän teemme seuraavassa osiossa.

Vastauksen valmisteleminen

  1. Kun "output.json" -tiedosto on avattuna Visual Studio Codessa, käytä Ctrl+Vaihto+I-näppäinyhdistelmää.

JSON-kohteen pitäisi päivittyä, jotta se jakautuu useisiin riveihin ja on helpommin luettavassa muodossa. Lisätietoja vastauksen ominaisuuksista ja arvoista on tietohakemiston artikkelissa Learnin hakemiston ohjelmointirajapinnan kehittäjän viiteopas.

Vastauksen muuntaminen laskentataulukoksi

Monet käyttäjät käyttävät Learn-hakemiston ohjelmointirajapintaa yksittäisissä tehtävissä tai tarkistamisessa sen sijaan, että he integroivat sen järjestelmään. Näissä käyttötapauksissa voi olla hyödyllistä muuntaa JSON-vastaus CSV- tai Excel-muotoon, jotta sitä voidaan tarkastella laskentataulukona. Voit käyttää mitä tahansa suositeltua muuntamistyökalua, mutta tässä voimme käyttää Flatfile Json -muunninta CSV-muuntimeen.

  1. Siirry kohteeseen: https://csvjson.com/json2csv.
  2. Lataa tulostetiedosto.
  3. Valitse Muunna.
  4. Valitse Lataa.

Muistiinpano

Käytä erittäin varoen ulkoisia verkkotyökaluja tietojen muuntamiseen ja harkitse, mitä tietoja käytät niihin. Learnin hakemiston ohjelmointirajapinnan tapauksessa vastaus on julkisesti saatavilla eikä se edellytä todentamista. Verkkotyökalun avulla voi siis muuntaa muotoa.

Kokeile lisää kyselyitä

Kokeile lisää kyselyitä noudattamalla yllä olevia ohjeita, kuten alla lueteltuja kyselyitä. Näet, miten vastaustiedoston koko muuttuu kunkin kohdalla ja miten ne eroavat objekteissa.

Kuvaus Kysely
Kaikki Learnin hakemiston ohjelmointirajapinnan kohteet https://learn.microsoft.com/api/catalog/
Kaikki espanjankieliset moduulit https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules
Kaikki moduulit, joiden suosiopisteet ovat vähintään 0,9 https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9
Kaikki aloittijoiden suojauskoulutus ja sertifiointiobjektit https://learn.microsoft.com/api/catalog/?level=beginner&subject=security
Kaikki kehittyneet helppokäyttötoimintojen moduulit, joiden suosio on yli 0,5 ja joita on päivitetty viimeisen kuukauden aikana https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01

Seuraavat vaiheet

Suosittelemme, että tutustut alla oleviin resursseihin ja autat sinua kehitysmatkallasi:

  • Last updated on