Lue englanniksi

Jaa


Microsoft Learnin hakemiston ohjelmointirajapinnan ominaisuuksien yleiskatsaus

Microsoft Learnin hakemiston ohjelmointirajapinta on REST-pohjainen verkko-ohjelmointirajapinta, jonka avulla voit lähettää verkkopohjaisen kyselyn Microsoft Learniin ja saada tiedot käytettävissä olevista koulutussisällöistä ja sertifiointikokeista, kuten otsikot, käsitellyt tuotteet, tasot, linkit koulutukseen ja muihin metatietoihin, ja palauttaa JSON-koodatun vastauksen tietojen kanssa.

Se palauttaa tiedot kaikista seuraavista julkisesti saatavilla olevista:

  • Moduulit
  • Units
  • Oppimispolut
  • Sovelletun osaamisen valmiude
  • Sertifioinnit
  • Tentit
  • Ohjatut kurssit

Huomautus

Osana äskettäistä Microsoft Learn -sivustopäivitystä learn.microsoft.com-toimialueella on saatavilla uusi hakemiston ohjelmointirajapinnan päätepiste. Vanha päätepiste toimii edelleen odotetulla tavalla, mutta uuteen päätepisteeseen vaihtamisen etuna on, että se antaa sinulle parannettuja ominaisuuksia, kuten lisää kyselyparametreja.

Käyttötapaukset

  • Tarkastele Microsoft Learn -koulutus- ja/tai sertifiointitarjonnan metatietoja
  • Hanki luettelo Microsoft Learnin koulutus- ja/tai sertifiointitarjouksista, jotta voit linkittää niitä omasta verkkokokemuksestasi

Learnin hakemiston ohjelmointirajapinnan toiminta

Ohjelmointirajapinta on REST-pohjainen verkko-ohjelmointirajapinta, joka palauttaa JSON-koodatun vastauksen. Jos haluat pyytää koko luettelon, lähetä GET-pyyntö seuraavaan päätepisteeseen:

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

Tuloste näyttää samalta kuin alla olevassa näyttökuvassa. Marraskuusta 2022 alkaen täysi vastaus on noin 13 Mt.

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

Jokainen oppimishakemiston kohde on objekti, joka sisältää joukon metatietoja kullekin. Täydellinen tietohakemisto ja muut vaihtoehdot on lueteltu Microsoft Learnin hakemiston ohjelmointirajapinnan kehittäjän dokumentaatiossa. Julkaisutiedoista (linkki) näemme myös uusimmat päivitykset ja tiedot parhaista käytännöistä .

Jos olet kiinnostunut käyttämään sitä, tutustu artikkeliin Microsoft Learnin hakemiston ohjelmointirajapinnan käyttö cURL:n ja Visual Studio Coden avulla.

Edellytykset

Microsoft Learnin hakemiston ohjelmointirajapinnan käyttämiseen ei tarvita todennusta. Käyttäjät voivat käyttää haluamaansa ohjelmointirajapinnan pyyntömenetelmää, kuten cURL:ää, Postmania jne.

Esimerkkejä

Alla on muutamia tapoja, joilla voimme nähdä käyttäjien käyttävän Learnin hakemiston ohjelmointirajapintaa:

  • Viva Learning on käyttänyt Learnin hakemiston ohjelmointirajapintaa tarjotakseen Microsoft Learn -hakemiston osana sen ydinkokemusta.
  • Organisaatiot ja oppilaitokset käyttävät Learnin hakemiston ohjelmointirajapintaa luettelotietojen noutamiseen ja niiden julkaisemiseen sisäisissä oppimisenhallintajärjestelmissään, jotta niiden työntekijät ja opiskelijat voivat helposti käyttää niitä.
  • Oppimisen palveluntarjoajat hakevat luettelotietoja Learnin hakemiston ohjelmointirajapinnasta ja julkaisevat ne asiakkaiden oppimiskokemuksissaan.

Käytettävyys ja hinnoittelu

Microsoft Learnin hakemiston ohjelmointirajapinta on julkisesti saatavilla Microsoftin ohjelmointirajapintojen käyttöehtojen mukaisesti. Ohjelmointirajapinnan käyttäminen ei ole maksullista.

Rajoitukset

  • Ohjelmointirajapinta sisältää julkisesti saatavilla olevia moduuleja, yksiköitä, oppimispolkuja, opettajajohtoisia kursseja, kokeita ja sertifiointeja. Se ei tulosta dokumentaatiota, koodinäytteitä, esityksiä tai tapahtumia tällä hetkellä.
  • Ohjelmointirajapinta päivittyy vähintään kerran päivässä.
  • Päivitykset toimitetaan ohjelmointirajapintaversioon päivitysten kauttaLue lisätietoja hakemiston ohjelmointirajapinnan julkaisutiedoista.

Seuraavat vaiheet

Jos haluat lisätietoja Learnin hakemiston ohjelmointirajapinnasta, tutustu seuraaviin artikkeleihin: