Freigeben über

Referenzdokumentation für Entwickler*innen zur Microsoft Learn-Katalog-API

  • Artikel

Dieser Artikel enthält Informationen für Entwickler*innen und Anforderer*innen, die die Microsoft Learn-Katalog-API implementieren. Es wird auch empfohlen, die Best Practices für die Learn-Katalog-API, die Versionshinweise und die häufig gestellten Fragen zu lesen, um den Lernprozess zu unterstützen.

API-Endpunkt

Die Katalog-API von Microsoft Learn ist eine REST-basierte Web-API, die eine mit JSON-codierte Antwort zurückgibt. Um den vollständigen Katalog abzufragen, senden Sie eine GET-Anforderung an:

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

Hinweis

Der oben aufgeführte Endpunkt ist der aktuelle Endpunkt. Sollten Sie einen anderen, älteren Endpunkt verwenden, funktioniert dieser weiterhin wie gewohnt. Wenn Sie jedoch zum neuen Endpunkt wechseln, können Sie erweiterte Features wie zusätzliche Abfrageparameter nutzen.

Abfrageparameter

Nachfolgend finden Sie die Abfrageparameter, die in der Anforderung enthalten sein können. Alle sind optional. Sie müssen die Abfrageparameterwerte als URL codieren. Sie können den Endpunkt mit keinem, einem, einigen oder allen dieser Parameter verwenden.

Wichtig

Wenn Sie mehrere Parameter verwenden, wird die Abfrage mit dem AND-Operator ausgewertet.

Name Wert type Erforderlich Beispiel
locale Ein einzelner gültiger Gebietsschemacode aus der Liste der unterstützten Gebietsschemas. Die zurückgegebenen Metadaten befinden sich, wenn verfügbar, im angeforderten Gebietsschema. Wenn dieser Parameter nicht angegeben wird, wird die en-us-Antwort zurückgegeben. Zeichenfolge Nein ?locale=en-us
type Eine durch Trennzeichen getrennte Liste mit einem oder mehreren Inhalts- oder Taxonomienobjekten der obersten Ebene, die derzeit in der Antwort zurückgegeben werden. Unterstützte Werte sind: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects. Zeichenfolge Nein ?type=modules,learningPaths
uid Eine durch Trennzeichen getrennte Liste einer oder mehrerer gültiger eindeutiger Inhalts-IDs (UID) aus den verfügbaren Inhaltstypen. Hinweis: Bei UIDs wird die Groß-/Kleinschreibung beachtet. Zeichenfolge Nein ?uid=learn.azure.intro-to-azure-fundamentals
last_modified Ein Operator und ein datetime-Datentyp zum Filtern nach dem Datum der letzten Änderung von Objekten. Der Operator umfasst lt (kleiner als), lte (kleiner als oder gleich), eq (gleich), gt (größer als) und gte (größer als oder gleich). Wenn Sie diesen Parameter verwenden, wird der Operator standardmäßig auf gte festgelegt, wenn er nicht angegeben ist. Zeichenfolge Nein ?last_modified=gte 2022-01-01
popularity Ein Operator und Wert, der nach dem Popularitätswert (in einem Bereich von 0 bis 1) von Objekten gefiltert werden soll. Der Operator umfasst lt (kleiner als), lte (kleiner als oder gleich), eq (gleich), gt (größer als) und gte (größer als oder gleich). Wenn Sie diesen Parameter verwenden, wird der Operator standardmäßig auf gte festgelegt, wenn er nicht angegeben ist. Zeichenfolge Nein ?popularity=gte 0.5
level Eine durch Trennzeichen getrennte Liste einer oder mehrerer der derzeit verfügbaren Ebenen (die vollständige Liste befindet sich im levels-Objekt der API-Antwort). Zeichenfolge Nein ?level=beginner
Rolle (role) Eine durch Trennzeichen getrennte Liste einer oder mehrerer der derzeit verfügbaren Rollen (die vollständige Liste befindet sich im roles-Objekt der API-Antwort). Zeichenfolge Nein ?role=developer
product Eine durch Trennzeichen getrennte Liste einer oder mehrerer der derzeit verfügbaren Rollen (die vollständige Liste befindet sich im products-Objekt der API-Antwort). Die API unterstützt keine Produkthierarchie. Fügen Sie daher jedes Produkt zur Liste hinzu, die Sie in Ihre Abfrage einschließen möchten. Zeichenfolge Nein ?product=azure
subject Eine durch Trennzeichen getrennte Liste einer oder mehrerer der derzeit verfügbaren Rollen (die vollständige Liste befindet sich im subjects-Objekt der API-Antwort). Die API unterstützt keine Subjekthierarchie. Fügen Sie daher alle Subjekte zur Liste hinzu, die Sie in Ihre Abfrage aufnehmen möchten. Zeichenfolge Nein ?subject=cloud-computing

Beispielabfragen

Anhand der unten aufgeführten Abfragen können Sie nachvollziehen, was Sie anfordern können und wie die Anforderung erstellt werden kann.

BESCHREIBUNG Abfrage
Alle Elemente in der Katalog-API von Learn https://learn.microsoft.com/api/catalog/
Alle spanischen Module https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules
Alle Module mit einer Beliebtheitsbewertung von 0,9 oder höher https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9
Alle Sicherheitsschulungs- und Zertifizierungsobjekte für Anfänger*innen https://learn.microsoft.com/api/catalog/?level=beginner&subject=security
Alle barrierefreien Module mit einer Beliebtheitsbewertung von über 0,5, die im letzten Monat aktualisiert wurden https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01

API-Antwort

Der Dienst kann die folgenden HTTP-Statuscodes zurückgeben.

Statuscode BESCHREIBUNG
200 Erfolg. Der Antworttext enthält die mit JSON codierten Daten.
400 Einer der Abfrageparameter fehlt oder ist ungültig.
404 Die URL konnte auf dem Server nicht gefunden werden.
500 Unerwarteter Serverfehler.
503 Der Dienst ist vorübergehend nicht verfügbar.

Eine erfolgreiche Antwort enthält wie nachfolgend dargestellt Informationen über alle Module und Lernpfade.

Antworttext

Ein erfolgreicher Antworttext wird in JSON codiert und verfügt über 12 Abschnitte:

{
    "modules": [ ... ],
    "units": [...],
    "learningPaths": [ ... ],
    "appliedSkills": [ ... ],
    "mergedCertifications": [ ... ],
    "certifications": [ ... ],
    "exams": [ ... ],
    "courses": [ ... ],
    "levels": [ ... ],
    "products": [ ... ],
    "roles": [ ... ],
    "subjects": [...],
}

Die einzelnen Arrays verfügen über mindestens ein mit JSON codiertes Objekt, das die für diesen Abschnitt spezifischen Daten enthält.

  1. modules: Ein Array veröffentlichter Module
  2. units: Ein Array veröffentlichter Einheiten
  3. learningPaths: Ein Array veröffentlichter Lernpfade
  4. appliedSkills: ist ein Array veröffentlichter angewandter Fähigkeiten.
  5. mergedCertifications: ist ein Array veröffentlichter Zertifizierungen, die mit Prüfungen zusammengeführt werden.
  6. certifications: Ein Array veröffentlichter Zertifizierungen
  7. exams: Ein Array veröffentlichter Prüfungen
  8. courses: Ein Array veröffentlichter Präsenzschulungen
  9. levels: Ein Array möglicher Zielgruppenebenen
  10. products: Ein Array möglicher Produkte und Dienste aus dem Katalog
  11. roles: Ein Array möglicher Auftragsrollen
  12. subjects: Ein Array möglicher Thementags

Moduldatensätze

Moduldatensätze

Die einzelnen Moduldatensätze sind folgendermaßen aufgebaut:

{
    "summary": "Explore the core concepts of cloud computing and how it can help your business.",
    "levels": [
        "beginner"
    ],
    "roles": [
        "administrator",
        "business-analyst",
        "developer"
    ],
    "products": [
        "azure",
        "azure-portal",
        "azure-resource-manager"
    ],
    "subjects": [
        "data-visualization"
    ],
    "uid": "learn.principles-cloud-computing",
    "type": "module",
    "title": "Cloud Concepts - Principles of cloud computing",
    "duration_in_minutes": 62,
    "rating": {
        count: 2014,
        average: 4.84
    },
    "popularity": 0.8839785477023878, 
    "icon_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing.svg",
    "social_image_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing-social.png",
    "locale": "en-us",
    "last_modified": "2018-09-24T00:00:00Z",
    "url": "https://learn.microsoft.com/learn/modules/principles-cloud-computing",
    "firstUnitUrl": "https://learn.microsoft.com/learn/modules/principles-cloud-computing/1-introduction",
    "units": [
        "learn.principles-cloud-computing.1-introduction",
        "learn.principles-cloud-computing.2-types-of-cloud-computing",
        "learn.principles-cloud-computing.3-benefits-of-cloud-computing",
        "learn.principles-cloud-computing.4-categories-of-cloud-services",
        "learn.principles-cloud-computing.5-knowledge-check",
        "learn.principles-cloud-computing.6-summary"
    ],
    "number_of_children": 6
}

Felddetails

Feld Typ Beschreibung
summary string Eine Zeichenfolge, die das Modul kurz beschreibt. Der Wert wird als HTML-Absatztag angegeben, bei dem der innere Text die Zusammenfassung darstellt.
levels array of strings Eine Liste der Ebenen, die diesem Modul zugeordnet sind, die angeben, wie viel Erfahrung in der Rolle erforderlich ist, um alle Aspekte dieses Moduls zu verstehen. Details zu den Einheiten finden sich in den Ebenendatensätzen.
roles array of strings Eine Liste der Auftragsrollen, für die das Modul relevant ist
products array of strings Eine Liste relevanter Produkte, die im Modul enthalten sind Details zu den Produkten finden sich in den Produktdatensätzen.
subjects array of strings Eine Liste relevanter Themen, die im Lernpfad enthalten sind
uid string Ein eindeutiger Bezeichner für dieses Modul: Dieser Wert ist überall in Microsoft Learn eindeutig.
type string Der Datensatztyp. Der Wert lautet immer „module“.
title string Der Titel des Moduls im angeforderten Gebietsschema oder alternativ in Englisch (USA)
duration_in_minutes integer Die durchschnittliche Zeit in Minuten, die für das Modul benötigt wird
rating Objekt Enthält sowohl count (Anzahl von Personen, die das Modul bewertet haben) als auch average (aggregierte Bewertungen auf einer Skala von 1 bis 5).
popularity double Dies ist ein normalisierter Wert zwischen 0 und 1, der die Beliebtheit des Moduls angibt.
icon_url string Eine vollqualifizierte URL eines SVG-Bildes (100 x 100), das die Grafik zum Modulerfolg mit einem transparenten Hintergrund darstellt.
social_image_url Zeichenfolge Eine vollqualifizierte URL eines PNG-Bildes, das die Grafik zum Modulerfolg mit einem rechteckigen undurchsichtigen Hintergrund darstellt und für Social Media oder Kacheln geeignet ist. Wenn diese Eigenschaft für dieses Modul nicht verfügbar ist, wird sie in der Antwort nicht zurückgegeben.
locale string Die Sprache, in der diese JSON-Daten geschrieben sind. Dieser Wert entspricht dem angeforderten Gebietsschema, wenn verfügbar. Andernfalls lautet er „en-us“.
last_modified date Das Datum, an dem das Modul zuletzt überarbeitet wurde
url string Eine vollqualifizierte URL zum Learn-Modul im angeforderten Gebietsschema
firstUnitUrl Zeichenfolge Eine vollqualifizierte URL zur ersten Lerneinheit des Learn-Moduls im angeforderten Gebietsschema
units array of strings Eine Liste der UIDs der zugeordneten Einheiten. Details zu den Einheiten finden sich in den Einheitendatensätzen.
number_of_children integer Die Anzahl der Seiten (Einheiten) des Moduls

Einheitendatensätze

Die einzelnen Einheitendatensätze sind folgendermaßen aufgebaut:

{
    "uid": "learn.azure.fundamental-azure-concepts.types-of-cloud-computing",
    "type": "unit",
    "title": "Discuss different types of cloud models",
    "duration_in_minutes": 5,
    "locale": "en-us",
    "last_modified": "2021-12-09T02:45:00+00:00"
},

Hinweis

Der Einheitendatensatz enthält die zugeordnete URL nicht, da Einheiten nicht als eigenständiger Inhalt geschrieben werden. Sie sollen in einer bestimmten Reihenfolge für das Modul übernommen werden. Deswegen haben wir den Link auf der Moduldetailseite und in der ersten Einheit im Moduldatensatz hinzugefügt. Benutzer können an dieser Stelle beginnen und dann mit den weiteren Inhalten fortfahren. Mit Einheitendatensätzen können Sie aber Details zu den Einheiten abrufen, die in Lernverwaltungssysten o. ä. angezeigt werden sollen.

Felddetails

Feld Typ Beschreibung
uid string Ein eindeutiger Bezeichner für dieses Modul: Dieser Wert ist überall in Microsoft Learn eindeutig.
type string Der Datensatztyp. Der Wert lautet immer „unit“.
title Zeichenfolge Der Titel der Einheit im angeforderten Gebietsschema oder alternativ in Englisch (USA).
duration_in_minutes Die Dauer der Einheit. Wenn Sie alle „duration_in_minutes“ der Einheiten hinzufügen, die den einzelnen Modulen zugeordnet sind, erhalten Sie die gesamte Modulzeit.
locale string Die Sprache, in der diese JSON-Daten geschrieben sind. Dieser Wert entspricht dem angeforderten Gebietsschema, wenn verfügbar. Andernfalls lautet er „en-us“.
last_modified date Das Datum, an dem das Modul zuletzt überarbeitet wurde

Lernpfaddatensätze

Die einzelnen Lernpfade sind folgendermaßen aufgebaut:

{
    "summary": "Azure Functions enable the creation of event driven, compute-on-demand systems that can be triggered by various external events. Learn how to leverage functions to execute server-side logic and build serverless architectures.",
    "levels": [
        "beginner",
        "intermediate"
    ],
    "roles": [
        "developer",
        "solution-architect"
    ],
    "products": [
        "azure",
        "azure-portal",
        "azure-functions",
        "azure-cosmos-db",
        "azure-cloud-shell"
    ],
    "subjects": [
        "data-visualization"
    ],
    "uid": "learn.create-serverless-applications",
    "type": "learningPath",
    "title": "Create serverless applications",
    "duration_in_minutes": 450,
    "rating": {
        count: 2014,
        average: 4.84
    },
    "popularity": 0.8839785477023878, 
    "icon_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications.svg",
    "social_image_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications-social.png",
    "locale": "en-us",
    "last_modified": "2018-12-27T00:00:00Z",
    "url": "https://learn.microsoft.com/learn/paths/create-serverless-applications",
    "firstModuleUrl": "https://learn.microsoft.com/learn/modules/choose-azure-service-to-integrate-and-automate-business-processes/",
    "modules": [
        "learn.choose-azure-service-to-integrate-and-automate-business-processes",
        "learn.create-serverless-logic-with-functions",
        "learn.execute-azure-function-with-triggers",
        "learn.chain-azure-functions-data-using-input-output-bindings",
        "learn.azure-create-long-running-serverless-workflow-with-durable-functions",
        "learn-pr.develop-test-deploy-azure-functions-core-tools",
        "learn.develop-test-deploy-azure-functions-with-visual-studio",
        "learn.azure.monitor-github-events-with-a-function-triggered-by-a-webhook",
        "learn.advocates.azure-functions-and-signalr"
    ],
    "number_of_children": 9
}

Felddetails

Feld Typ Beschreibung
summary string Eine Zeichenfolge, die den Lernpfad kurz beschreibt. Der Wert wird als HTML-Absatztag angegeben, bei dem der innere Text die Zusammenfassung darstellt.
levels array of strings Eine Liste der Ebenen, die diesem Lernpfad zugeordnet sind, die angeben, wie viel Erfahrung in der Rolle erforderlich ist, um alle Aspekte dieses Lernpfads zu verstehen. Details zu den Einheiten finden sich in den Ebenendatensätzen.
roles array of strings Eine Liste der relevanten Auftragsrollen für diesen Lernpfad.
products array of strings Eine Liste relevanter Produkte, die im Lernpfad enthalten sind Details zu den Produkten finden sich in den Produktdatensätzen.
subjects array of strings Eine Liste relevanter Themen, die im Lernpfad enthalten sind
uid string Ein eindeutiger Bezeichner für diesen Lernpfad: Dieser Wert ist überall in Microsoft Learn eindeutig.
type string Der Datensatztyp. Der Wert lautet immer „learningPath“.
title string Der Titel des Lernpfads im angeforderten Gebietsschema oder alternativ in Englisch (USA)
duration_in_minutes integer Die durchschnittliche Zeit in Minuten, die für den Lernpfad benötigt werden. Dieser Wert ist eine Summe aller Daten der enthaltenen Module.
rating Objekt Enthält sowohl count (Anzahl von Personen, die den Lernpfad bewertet haben) als auch average (aggregierte Bewertungen auf einer Skala von 1 bis 5).
popularity double Dies ist ein normalisierter Wert zwischen 0 und 1, der die Beliebtheit des Lernpfads angibt.
icon_url string Eine vollqualifizierte URL eines SVG-Bildes (100 x 100), das den Lernpfad darstellt.
social_image_url Zeichenfolge Eine vollqualifizierte URL eines PNG-Bildes, das die Grafik zum Lernpfaderfolg mit einem rechteckigen undurchsichtigen Hintergrund darstellt und für Social Media oder Kacheln geeignet ist. Wenn diese Eigenschaft für dieses Modul nicht verfügbar ist, wird sie in der Antwort nicht zurückgegeben.
locale string Die Sprache, in der diese JSON-Daten geschrieben sind. Dieser Wert entspricht dem angeforderten Gebietsschema, wenn verfügbar. Andernfalls lautet er „en-us“.
last_modified date Das Datum, an dem der Lernpfad zuletzt geändert wurde
url string Eine vollqualifizierte URL zum Lernpfad in Microsoft Learn im angeforderten Gebietsschema
firstModuleUrl Zeichenfolge Dies ist eine vollqualifizierte URL zum ersten Modul des Lernpfads in Microsoft Learn im angeforderten Gebietsschema.
modules array of strings Eine Liste der zugeordneten Modul-UIDs. Details zu den Modulen finden sich in den Moduldatensätzen.
number_of_children integer Die Anzahl der Module im Lernpfad

Datensätze für angewandte Fähigkeiten

Jeder Eintrag für angewandte Fähigkeiten hat die folgende Form:

{
    "uid": "applied-skill.deploy-and-configure-azure-monitor",
    "locale": "en-us",
    "url": "https://learn.microsoft.com/en-us/credentials/applied-skills/deploy-and-configure-azure-monitor/?WT.mc_id=api_CatalogApi",
    "title": "Deploy and configure Azure Monitor",
    "summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
    "levels": [
        "intermediate"
    ],
    "roles": [
        "administrator"
    ],
    "products": [
        "azure-monitor",
        "azure-virtual-machines",
        "azure-virtual-network",
        "windows-server"
    ],
    "subjects": [
        "it-management-monitoring"
    ],
    "study_guide": [
        {
            "uid": "learn.wwl.deploy-configure-azure-monitor",
            "type": "learningPath"
        }
    ],
    "last_modified": "2023-10-25T17:07:00+00:00"
}

Felddetails

Feld Typ Beschreibung
uid string Ein eindeutiger Bezeichner für diese angewendete Fähigkeit – dieser Wert wird in allen MS Learn eindeutig sein.
locale Zeichenfolge Die Sprache, in der diese JSON-Daten geschrieben sind. Dieser Wert entspricht dem angeforderten Gebietsschema, wenn verfügbar. Andernfalls lautet er „en-us“.
title Zeichenfolge Der Titel für die angewandte Qualifikation im angeforderten Gebietsschema oder Englisch (US) als Alternative.
summary Zeichenfolge Die Zusammenfassung für die angewendete Qualifikation im angeforderten Gebietsschema oder Englisch (US) als Alternative.
url Zeichenfolge Eine vollqualifizierte URL zum angewendeten Skill in Microsoft Learn im angeforderten Gebietsschema.
icon_url Zeichenfolge Eine vollqualifizierte URL zu einem SVG-Bild von 100x100, das die angewendete Fähigkeit darstellt (sofern verfügbar, andernfalls nicht enthalten).
levels Zeichenfolgen-Arrays Eine Liste der Ebenen, die dieser angewendeten Fähigkeit zugeordnet sind.
roles Zeichenfolgen-Arrays Eine Liste der relevanten Stellenrollen für diese angewandte Qualifikation. Details zu den Rollen finden sich in den Rollendatensätzen.
subjects array of strings Eine Liste der relevanten Themen, die diese angewandte Qualifikation abdeckt.
study_guide Array von Objekten Eine Liste der zugehörigen Inhalte, die für diese angewandte Qualifikation untersucht werden sollen. Details zu den Objekten finden sich in den zugeordneten Datensätzen.
last_modified date Das letzte Mal, wenn dass die angewendete Fähigkeit geändert wurde.

Zusammengeführte Zertifizierungsdatensätze

Jeder zusammengeführte Zertifizierungseintrag hat die folgende Form:

{
    "uid": "certification.d365-functional-consultant-manufacturing",
    "title": "Microsoft Certified: Dynamics 365 Supply Chain Management, Manufacturing Functional Consultant Associate",
    "summary": "<div class=\"WARNING\">\n<p>Warning</p>\n<p>This certification retired on June 30, 2023. You can renew it for at least six months after the retirement date by completing the free online assessment available on the <a href=\"/credentials/certifications/d365-functional-consultant-manufacturing/renew\">certification renewal page</a>. <a href=\"https://aka.ms/BACertPortfolioUpdatesBlog\">Read the blog post</a>.</p>\n</div>\n<p>If you’re a functional consultant or a business user with a deep understanding of manufacturing industry standards, this certification might be for you. You also need experience configuring and implementing Dynamics 365 Supply Chain Management to meet the needs of your organization. Supply chain management, manufacturing functional consultants are key resources who work with developers, solution architects, project managers, and functional consultants in finance, commerce, and supply chain.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Study the supply chain management and supply chain management, manufacturing modules on Microsoft Learn, and complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course that covers the MB-300 or MB-320 track.</li>\n<li>Take part in the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>, or join a user group.</li>\n<li>Shadow a manufacturing functional consultant in a manufacturing workstream.</li>\n<li>Get a mentor, tour manufacturing lines, and learn how things are made.</li>\n<li>Ask questions, and learn from experts and customers.</li>\n</ul>\n",
    "url": "https://learn.microsoft.com/en-us/credentials/certifications/d365-functional-consultant-manufacturing/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/en-us/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
    "last_modified": "2023-09-19T00:47:00+00:00",
    "type": "cert",
    "certification_type": "role-based",
    "products": [
        "dynamics-365",
        "dynamics-finance"
    ],
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "subjects": [],
    "renewal_frequency_in_days": 0,
    "prerequisites": [],
    "skills": [
        "Describe finance and operations apps, and extend apps by using Microsoft Power Platform technologies",
        "Configure administrative features and workflows",
        "Manage finance and operations data",
        "Validate and support solutions",
        "Configure Dynamics 365 Supply Chain Management, Manufacturing",
        "Manage manufacturing processes",
        "Implement master planning for production",
        "Implement other manufacturing features"
    ],
    "recommendation_list": [],
    "study_guide": [],
    "exam_duration_in_minutes": 0,
    "locales": [],
    "providers": [],
    "career_paths": []
}

Felddetails

Feld Typ Beschreibung
uid Zeichenfolge Ein eindeutiger Bezeichner für diese Zertifizierung: Dieser Wert ist überall in Microsoft Learn eindeutig.
title Zeichenfolge Der Titel der Zertifizierung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
summary Zeichenfolge Die Zusammenfassung für die Zertifizierung im angeforderten Gebietsschema oder Englisch (US) als Alternative.
url Zeichenfolge Eine vollqualifizierte URL zur Zertifizierung in Microsoft Learn im angeforderten Gebietsschema.
icon_url Zeichenfolge Eine vollqualifizierte URL eines SVG-Bildes (100 x 100), das die Zertifizierung darstellt.
last_modified date Das letzte Mal, dass diese Zertifizierung geändert wurde.
type Zeichenfolge Der Datensatztyp. Der Wert lautet immer „cert“.
certification_type Zeichenfolge Der Zertifizierungstyp. Mögliche Werte sind „fundamentals“, „mce“, „mcsa“, „mcsd“, „mcse“, „mos“, „mta“, „role-based“, „specialty“.
products array of strings Eine Liste der relevanten Produkte, die diese Zertifizierung umfasst. Details zu den Produkten finden sich in den Produktdatensätzen.
levels array of strings Eine Liste der Ebenen, die dieser Zertifizierung zugeordnet sind, die angeben, wie viel Erfahrung in der Rolle erforderlich ist, um alle Aspekte der Prüfungen dieser Zertifizierung zu verstehen. Details zu den Einheiten finden sich in den Ebenendatensätzen.
roles array of strings Eine Liste der relevanten Auftragsrollen für diese Zertifizierung. Details zu den Rollen finden sich in den Rollendatensätzen.
subjects array of strings Eine Liste der relevanten Themen, die diese Zertifizierung umfasst.
renewal_frequency_in_days integer Die Anzahl der Tage, bevor diese Zertifizierung abläuft und verlängert werden muss. Wenn der Wert 0 ist, läuft die Zertifizierung nicht ab.
prerequisites Zeichenfolgen-Arrays Eine Liste der empfohlenen Voraussetzungen, um diese Zertifizierung zu erhalten. Details zu den Zertifizierungen können in den Zertifizierungsunterlagen referenziert werden.
skills Zeichenfolgen-Arrays Eine Liste aller im Examen für diese Zertifizierung geprüften Fähigkeiten.
recommendation_list Zeichenfolgen-Arrays Eine Liste der Empfehlungen im Zusammenhang mit dieser Zertifizierung.
study_guide Array von Objekten Eine Liste der zugeordneten Inhalte, die für diese Zertifizierung erlernt werden müssen. Details zu den Objekten finden sich in den zugeordneten Datensätzen.
exam_duration_in_minutes integer Die Anzahl der Minuten, die für die Prüfung angesetzt wurden.
locales Zeichenfolgen-Arrays Eine Liste der Sprachen, in der diese Zertifizierung angeboten wird.
providers Array von Objekten Eine Liste der Anbieter für diese Zertifizierung. Der Typ beschreibt den Anbieter und eine vollqualifizierte URL mit einem Link zum Vereinbaren einer Prüfung mit dem Anbieter.
career_paths Array von Objekten Eine Liste der Karrierepfade für diese Zertifizierung.

Hinweis

Zertifizierungen, die nur eine Prüfung erfordern, werden als Teil dieser mergedCertifications-Eigenschaft zurückgegeben.

Zertifizierungsdatensätze

Die einzelnen Zertifizierungsdatensätze sind folgendermaßen aufgebaut:

{
    "uid": "certification.d365-functional-consultant-customer-service",
    "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate",
    "subtitle": "Microsoft Dynamics 365 Customer Service functional consultants are responsible for implementing omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction.",
    "url": "https://learn.microsoft.com/cert-exam-sandbox/cert/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
    "type": "cert",
    "certification_type": "role-based",
    "exams": [
        "exam.77-881"
    ],
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "study_guide": [
        {
            "uid": "learn.get-started-with-d365",
            "type": "module"
        },
        {
            "uid": "learn.d365-notebook",
            "type": "module"
        },
        {
            "uid": "learn.d365-fundamentals",
            "type": "learningPath"
        }
    ]
}

Felddetails

Feld Typ Beschreibung
uid Zeichenfolge Ein eindeutiger Bezeichner für diese Zertifizierung: Dieser Wert ist überall in Microsoft Learn eindeutig.
title Zeichenfolge Der Titel der Zertifizierung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
subtitle Zeichenfolge Der Untertitel der Zertifizierung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
url Zeichenfolge Eine vollqualifizierte URL zur Zertifizierung in Microsoft Learn im angeforderten Gebietsschema.
icon_url Zeichenfolge Eine vollqualifizierte URL eines SVG-Bildes (100 x 100), das die Zertifizierung darstellt.
type string Der Datensatztyp. Der Wert lautet immer „cert“.
certification_type Zeichenfolge Der Zertifizierungstyp. Mögliche Werte sind „fundamentals“, „mce“, „mcsa“, „mcsd“, „mcse“, „mos“, „mta“, „role-based“, „specialty“.
exams array of strings Eine Liste der zugeordneten Prüfungen, die für diese Zertifizierung erforderlich sind. Details zu den Einheiten finden sich in den Zertifizierungsdatensätzen.
levels array of strings Eine Liste der Ebenen, die dieser Zertifizierung zugeordnet sind, die angeben, wie viel Erfahrung in der Rolle erforderlich ist, um alle Aspekte der Prüfungen dieser Zertifizierung zu verstehen. Details zu den Einheiten finden sich in den Ebenendatensätzen.
roles array of strings Eine Liste der relevanten Auftragsrollen für diese Zertifizierung. Details zu den Rollen finden sich in den Rollendatensätzen.
study_guide Array von Objekten Eine Liste der zugeordneten Inhalte, die für diese Zertifizierung erlernt werden müssen. Details zu den Objekten finden sich in den zugeordneten Datensätzen.

Hinweis

Zertifizierungen, die mehr als eine Prüfung erfordern, werden in diesem Zertifizierungseintrag stehen, der auf das Prüfungsarray verweist.

Prüfungsdatensätze

Die einzelnen Prüfungsdatensätze sind folgendermaßen aufgebaut:

{
    "uid": "exam.77-881",
    "title": "Word 2010",
    "subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
    "display_name": "77-881",
    "url": "https://learn.microsoft.com/cert-exam-sandbox/exam/77-881/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
    "pdf_download_url": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
    "practice_test_url": "https://www.mindhub.com/70-413-Designing-and-Implementing-a-Server-Infrast-p/mu-70-413_p.htm?utm_source=microsoft&amp;utm_medium=certpage&amp;utm_campaign=msofficialpractice",
    "practice_assessment_url": "https://learn.microsoft.com/en-us/certifications/exams/{exam}/practice/assessment?assessment-type=practice&assessmentId={assessmentId}",
    "locales": [],
    "type": "exam",
    "courses": [
        "course.pl-200t00",
        "course.mb-230t01"
    ],
    "levels": [
        "beginner"
    ],
    "roles": [
        "business-user"
    ],
    "products": [
        "office-word"
    ],
    "providers": [],
    "study_guide": [
        {
            "uid": "learn.get-started-with-word-2010",
            "type": "module"
        },
        {
            "uid": "learn.office2010-notebook",
            "type": "module"
        },
        {
            "uid": "learn.office2010-fundamentals",
            "type": "learningPath"
        }
    ]
}

Felddetails

Feld Typ Beschreibung
uid Zeichenfolge Ein eindeutiger Bezeichner für diese Prüfung: Dieser Wert ist überall in Microsoft Learn eindeutig.
title Zeichenfolge Der Titel der Prüfung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
subtitle Zeichenfolge Der Untertitel der Prüfung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
display_name Zeichenfolge Der Anzeigename der Prüfung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
url Zeichenfolge Eine vollqualifizierte URL zur Prüfung in Microsoft Learn im angeforderten Gebietsschema.
icon_url Zeichenfolge Eine vollqualifizierte URL eines SVG-Bildes (100 x 100), das die Prüfung darstellt.
pdf_download_url Zeichenfolge Eine vollqualifizierte URL zur PDF-Datei, die die bei dieser Prüfung gemessenen Fertigkeiten erläutert.
practice_test_url Zeichenfolge Eine vollqualifizierte URL zu einem Übungstest, der der Prüfung zugeordnet ist.
practice_assessment_url Zeichenfolge Eine vollqualifizierte URL zu einem kostenlosen Übungsassessment für das Examen
locales array of strings Eine Liste der Sprachen, in denen diese Prüfung angeboten wird.
type string Der Datensatztyp. Der Wert lautet immer „exam“.
courses array of strings Eine Liste der zugeordneten Kurs-UIDs. Details zu den Kursen finden sich in den Kursdatensätzen.
levels array of strings Eine Liste der Ebenen, die dieser Prüfung zugeordnet sind, die angeben, wie viel Erfahrung in der Rolle erforderlich ist, um alle Aspekte dieser Prüfung zu verstehen. Details zu den Einheiten finden sich in den Ebenendatensätzen.
roles array of strings Eine Liste der relevanten Auftragsrollen für diese Prüfung. Details zu den Rollen finden sich in den Rollendatensätzen.
products array of strings Eine Liste der relevanten Produkte, die diese Prüfung abdeckt. Details zu den Produkten finden sich in den Produktdatensätzen.
providers Array von Objekten Eine Liste der Anbieter dieser Prüfung. Der Typ beschreibt den Anbieter und eine vollqualifizierte URL mit einem Link zum Vereinbaren einer Prüfung mit dem Anbieter.
study_guide Array von Objekten Eine Liste der zugeordneten Inhalte, die für diese Prüfung erlernt werden müssen. Details zu den Objekten finden sich in den zugeordneten Datensätzen.

Präsenzschulungsdatensätze

Die einzelnen Kursdatensätze sind folgendermaßen aufgebaut:

{
    "uid": "course.mb-230t01",
    "course_number": "MB-230T01",
    "title": "Microsoft Dynamics 365 Customer Service - added non-exist studyguide",
    "summary": "Microsoft Dynamics 365 Customer Service offers any organization an opportunity for customer success. Using tools such as automatic case creation and queue management frees up your time to dedicate it where you can have a greater impact, directly with your customers. Join our team of globally recognized experts as they take you step by step from creating cases to interacting with customers to resolving those cases. Once you’ve resolved those cases you can learn from data analysis the key details to help you resolve similar cases faster or avoid new issues altogether. A Dynamics 365 Customer Engagement Functional Consultant is responsible for performing discovery, capturing requirements, engaging subject matter experts and stakeholders, translating requirements, and configuring the solution and applications. The Functional Consultant implements a solution using out of the box capabilities, codeless extensibility, application and service integrations.",
    "duration_in_hours": 72,
    "url": "https://learn.microsoft.com/cert-exam-sandbox/course/mb-230t01/?WT.mc_id=api_CatalogApi",
    "icon_url": "https://learn.microsoft.com/media/learn/certification/course.svg",
    "locales": [
        "en"
    ],
    "type": "course",
    "certification": "certification.d365-functional-consultant-customer-service",
    "exam": "exam.77-881",
    "levels": [
        "intermediate"
    ],
    "roles": [
        "functional-consultant"
    ],
    "products": [
        "dynamics-365"
    ],
    "study_guide": [
        {
            "uid": "learn.align-requirements-in-azure",
            "type": "module"
        },
        {
            "uid": "learn.manage-resources-in-azure",
            "type": "learningPath"
        }
    ]
},

Felddetails

Feld Typ Beschreibung
uid Zeichenfolge Ein eindeutiger Bezeichner für diese Präsenzschulung: Dieser Wert ist überall in Microsoft Learn eindeutig.
course_number Zeichenfolge Der Nummern-ID der Präsenzschulung.
title Zeichenfolge Der Titel der Präsenzschulung im angeforderten Gebietsschema oder alternativ in Englisch (USA).
summary Zeichenfolge Eine Zeichenfolge, die die Präsenzschulung kurz beschreibt. Der Wert wird als HTML-Absatztag angegeben, bei dem der innere Text die Zusammenfassung darstellt.
duration_in_hours integer Die durchschnittliche Zeit in Stunden, die diese Präsenzschulung in Anspruch nimmt.
url Zeichenfolge Eine vollqualifizierte URL zur Detailseite der Präsenzschulung in Microsoft Learn im angeforderten Gebietsschema.
icon_url Zeichenfolge Eine vollqualifizierte URL eines SVG-Bildes (100 x 100), das den Abschluss der Präsenzschulung darstellt.
locales array of strings Eine Liste der Sprachen, in denen diese Präsenzschulung offiziell angeboten wird. Weitere Sprachen werden möglicherweise von Lernpartnern abgedeckt.
type string Der Datensatztyp. Der Wert ist für Präsenzschulungen immer „course“.
certification Zeichenfolge Zertifizierung, die der Präsenzschulung zugeordnet ist.
exam Zeichenfolge Prüfung, die der Präsenzschulung zugeordnet ist.
levels array of strings Eine Liste der Ebenen, die dieser Präsenzschulung zugeordnet sind, die angeben, wie viel Erfahrung in der Rolle erforderlich ist, um alle Aspekte dieses Kurses zu verstehen. Details zu den Einheiten finden sich in den Ebenendatensätzen.
study_guide Array von Objekten Eine vollqualifizierte URL zur PDF-Datei, die die bei dieser Zertifizierung gemessenen Fertigkeiten erläutert.

Ebene, Produkt, Rolle und Themendatensätze

Die Sammlungen levels, products, roles und subjects enthalten Anzeigenamen für die Werte, die in den Modul- und Lernpfaddaten verwendet werden. Alle vier Sammlungen weisen dieselbe Form auf:

{
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

id stimmt mit den Werten für die Ebenen, Produkte, Rollen und Themen in den anderen Katalogeinträgen überein. Der zugeordnete Wert name gibt dem Eintrag einen Eigennamen in Englisch. Das Array children ist optional und ermöglicht eine Hierarchie bei Werten, die untergeordnete Beziehungen aufweisen, z. B. Produkte.

Nachfolgend werden mehrere mögliche Rollen dargestellt:

{
    ...
    "roles": [
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

Hier finden Sie ein Beispiel für Produkte mit untergeordneten Elementen, mit denen eine spezifischere Produktkategorie angegeben werden kann.

{
    ...
    "products": [
        {
            "id": "dotnet",
            "name": ".NET",
            "children": [
                { "id": "dotnet-core", "name": ".NET Core" },
                { "id": "dotnet-standard", "name": ".NET Standard" },
                { "id": "aspnet-core", "name": "ASP.NET Core" },
                { "id": "ef-core", "name": "Entity Framework Core" }
            ]
        },
        {
            "id": "ms-graph",
            "name": "Microsoft Graph"
        },
        {
            "id": "office",
            "name": "Office",
            "children": [
                { "id": "office-365", "name": "Office 365" },
                { "id": "office-add-ins", "name": "Office Add-ins" },
                { "id": "office-teams", "name": "Teams" }
            ]
        },
        {
            "id": "sql-server",
            "name": "SQL Server"
        },
        ...
    ]
}

Codebeispiele

Es gibt viele Möglichkeiten, die Katalog-API von Learn aufzurufen. Im Folgenden finden Sie Codebeispiele, in denen gezeigt wird, wie sie verwendet werden kann.

jQuery

$(function() {
    var params = {
        locale:'en-us'
    };
    $.ajax({
        url: "https://learn.microsoft.com/api/learn/catalog?" + $.param(params),
            type: "GET"
    }).done(function(data) {
        alert("success");
    }).fail(function(error) {
        alert("error");
    });
})

.NET C#

public string GetCatalogData()
{
var client = new WebClient();
client.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko");
var response = client.DownloadString("https://learn.microsoft.com/api/learn/catalog?locale=en-us");
dynamic parsedJson = JsonConvert.DeserializeObject(response);
JsonConvert.SerializeObject(response, Formatting.Indented);
return Convert.ToString(response);
}

PHP mit cURL-Erweiterung

<?php 

// From URL to get webpage contents. 
$url = "https://learn.microsoft.com/api/learn/catalog"; 

// Initialize a CURL session. 
$ch = curl_init(); 

// Return Page contents. 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 
//grab URL and pass it to the variable. 
curl_setopt($ch, CURLOPT_URL, $url); 

$result = curl_exec($ch); 

echo $result;

?>

PYTHON 3 mit der „requests“-Bibliothek


#!/usr/bin/env python3
#Using Python 3.8.2 install 5/6/2020

import requests
import json

#if given error 'response / requests not defined', install requests via 'pip install requests' in the command line

parameters= {"locale": "en-us"}

response = requests.get("https://learn.microsoft.com/api/learn/catalog/", parameters)

#print(response.status_code)

rawJson = response._content

#Create python objects based on the data using json.loads

data = json.loads(rawJson)

print(data)

Nächste Schritte

Sehen Sie sich die folgenden Ressourcen an, um weitere Informationen zu erhalten: