Επισκόπηση δυνατοτήτων API Microsoft Learn Catalog

Το Microsoft Learn Catalog API είναι ένα Web API που βασίζεται σε REST και σας επιτρέπει να στείλετε ένα ερώτημα web στο Microsoft Learn και να λάβετε λεπτομέρειες σχετικά με το διαθέσιμο εκπαιδευτικό περιεχόμενο και τις εξετάσεις πιστοποίησης, όπως τίτλους, προϊόντα που καλύπτονται, επίπεδα, συνδέσεις σε εκπαίδευση και άλλα μετα-δεδομένα και επιστρέφει μια απόκριση με κωδικοποίηση JSON με τις πληροφορίες.

Επιστρέφει πληροφορίες σχετικά με όλα τα δημόσια διαθέσιμα στοιχεία:

  • Λειτουργικές μονάδες
  • Units
  • Διαδρομές εκμάθησης
  • Εφαρμοσμένες δεξιότητες
  • Πιστοποιήσεις
  • Εξετάσεις
  • Κύκλοι μαθημάτων καθοδηγούμενοι από εκπαιδευτή

Σημείωμα

Ως μέρος της πρόσφατης ενημέρωσης τοποθεσίας του Microsoft Learn, υπάρχει ένα νέο τελικό σημείο API Catalog διαθέσιμο στον τομέα learn.microsoft.com. Το παλιό τελικό σημείο θα εξακολουθήσει να λειτουργεί όπως αναμένεται, αλλά τα οφέλη της μετάβασης στο νέο τελικό σημείο είναι ότι θα σας παρέχει βελτιωμένες δυνατότητες, όπως πρόσθετες παραμέτρους ερωτήματος.

Περιπτώσεις χρήσης

  • Προβολή μετα-δεδομένων σχετικά με προσφορές εκπαίδευσης ή/και πιστοποίησης του Microsoft Learn
  • Τραβήξτε μια λίστα με τις προσφορές εκπαίδευσης ή/και πιστοποίησης του Microsoft Learn, προκειμένου να συνδεθείτε σε αυτά από τη δική σας online εμπειρία

Πώς λειτουργεί το API Learn Catalog

Το API είναι ένα API Web που βασίζεται σε REST και επιστρέφει μια απόκριση με κωδικοποίηση JSON. Για να ζητήσετε τον πλήρη κατάλογο, στείλτε μια αίτηση GET στο:

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

Το αποτέλεσμα θα μοιάζει με το παρακάτω στιγμιότυπο οθόνης. Από τον Νοέμβριο του 2022, η πλήρης απόκριση είναι περίπου 13 MB.

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

Κάθε στοιχείο καταλόγου εκμάθησης είναι ένα αντικείμενο, με ένα σύνολο μετα-δεδομένων διαθέσιμων για κάθε ένα. Το πλήρες λεξικό δεδομένων και άλλες επιλογές παρατίθενται στην τεκμηρίωση προγραμματιστή του API Microsoft Learn Catalog. Έχουμε επίσης σημειώσεις έκδοσης (σύνδεση) για να δούμε ποιες είναι οι πιο πρόσφατες ενημερώσεις και πληροφορίες βέλτιστων πρακτικών .

Εάν σας ενδιαφέρει να τη χρησιμοποιήσετε, ανατρέξτε στο άρθρο Γρήγορα αποτελέσματα με το API Microsoft Learn Catalog με χρήση cURL και Κώδικα Visual Studio.

Απαιτήσεις

Δεν απαιτείται έλεγχος ταυτότητας για πρόσβαση στο API Microsoft Learn Catalog. Οι χρήστες μπορούν να χρησιμοποιήσουν τη μέθοδο αίτησης API που προτιμούν, όπως cURL, Postman κ.λπ.

Παραδείγματα

Παρακάτω θα βρείτε μερικούς από τους πολλούς τρόπους με τους οποίους μπορούμε να δούμε τους χρήστες να χρησιμοποιούν το API Learn Catalog:

  • Η εκμάθηση Viva έχει χρησιμοποιήσει το API Learn Catalog για να προσφέρει τον κατάλογο του Microsoft Learn ως μέρος της βασικής του εμπειρίας.
  • Οι οργανισμοί και τα εκπαιδευτικά ιδρύματα χρησιμοποιούν το API Learn Catalog για να αντλούν πληροφορίες καταλόγου και να τις δημοσιεύουν στα εσωτερικά συστήματα διαχείρισης εκμάθησης (LMS), ώστε οι υπάλληλοι και οι μαθητές τους να μπορούν εύκολα να έχουν πρόσβαση σε αυτές.
  • Οι υπηρεσίες παροχής εκμάθησης χρησιμοποιούν το API Learn Catalog για να αντλούν πληροφορίες καταλόγου και να τις δημοσιεύουν στις εμπειρίες εκμάθησης των πελατών τους.

Διαθεσιμότητα και τιμολόγηση

Το API Microsoft Learn Catalog είναι διαθέσιμο στο κοινό και παρέχεται σύμφωνα με τον όρο των Όρων χρήσης των API της Microsoft. Δεν υπάρχει χρέωση για τη χρήση του API.

Περιορισμοί

  • Το API περιλαμβάνει δημόσια διαθέσιμες εκπαιδευτικές ενότητες, μονάδες, μαθησιακούς διαύλους, κύκλους μαθημάτων με καθοδήγηση από εκπαιδευτή, εξετάσεις και πιστοποιήσεις. Δεν εξάγει τεκμηρίωση, δείγματα κώδικα, εκπομπές ή συμβάντα αυτήν τη στιγμή.
  • Το API ανανεώνεται τουλάχιστον μία φορά την ημέρα.
  • Ενημερώσεις στην έκδοση API θα κοινοποιείται μέσω ενημερώσεων στο Σημειώσεις έκδοσης του API Learn Catalog.

Επόμενα βήματα

Για να μάθετε περισσότερα σχετικά με το API Learn Catalog, διαβάστε τα παρακάτω άρθρα: