Documentation de référence pour les développeurs sur l’API Catalog Microsoft Learn
Cet article fournit des informations pour les développeurs et les demandeurs qui implémentent l’API Catalog Microsoft Learn. Nous vous recommandons également de consulter les articles sur les meilleures pratiques, les notes de publication et les questions fréquentes (FAQ) en lien avec l’API Catalog Learn pour faciliter votre parcours de développement.
Point de terminaison d’API
L’API Catalog Microsoft Learn est une API REST web qui retourne une réponse encodée en JSON. Pour demander le catalogue complet, envoyez une demande GET à :
https://learn.microsoft.com/api/catalog/
Notes
Le point de terminaison listé ci-dessus est le point de terminaison actuel. Si vous utilisez un autre point de terminaison plus ancien, il fonctionnera comme lorsque vous l’avez intégré. Toutefois, l’avantage de basculer vers le nouveau point de terminaison est qu’il vous donnera des fonctionnalités améliorées telles que des paramètres de requête supplémentaires.
Paramètres de requête
Voici les paramètres de requête que la requête peut inclure. Tous sont facultatifs. Vous devez encoder les valeurs des paramètres de requête dans une URL. Vous pouvez utiliser le point de terminaison avec aucun, un, certains ou tous ces paramètres.
Important
Si vous en utilisez plusieurs, la requête est évaluée à l’aide de l’opérateur AND.
| Nom | Valeur | Type | Obligatoire | Exemple |
|---|---|---|---|---|
| locale | Un code de paramètres régionaux valide unique parmi la liste de paramètres régionaux pris en charge. Les métadonnées retournées sont alors indiquées dans les paramètres régionaux demandés si disponibles. Si ce paramètre n’est pas fourni, la réponse en-us est retournée. |
string | Non | ?locale=en-us |
| type | Liste séparée par des virgules d’un ou plusieurs des objets de contenu ou de taxonomies de niveau supérieur que nous fournissons actuellement dans la réponse à retourner. Les valeurs prises en charge sont les suivantes : modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects. |
string | Non | ?type=modules,learningPaths |
| uid | Liste séparée par des virgules d’un ou plusieurs ID uniques de contenu valides issus des types de contenu disponibles. Remarque : les uids respectent la casse. | string | Non | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | Opérateur et datetime permettant de filtrer en fonction de la date de dernière modification des objets. Les opérateurs inclus sont les suivants : lt (inférieur à), lte (inférieur ou égal à), eq (égal à), gt (supérieur à), (supérieur à), gte (supérieur à ou égal à). Lorsque vous utilisez ce paramètre, l’opérateur a la valeur par défaut gte en l’absence de spécification. |
string | Non | ?last_modified=gte 2022-01-01 |
| popularity | Opérateur et valeur permettant de filtrer en fonction de la valeur de popularité (dans une plage de 0 à 1) d’objets. Les opérateurs inclus sont les suivants : lt (inférieur à), lte (inférieur ou égal à), eq (égal à), gt (supérieur à), (supérieur à), gte (supérieur à ou égal à). Lorsque vous utilisez ce paramètre, l’opérateur a la valeur par défaut gte en l’absence de spécification. |
string | Non | ?popularity=gte 0.5 |
| level | Liste séparée par des virgules d’un ou plusieurs niveaux actuellement disponibles (la liste complète se trouve dans l’objet levels de la réponse de l’API). | string | Non | ?level=beginner |
| rôle | Liste séparée par des virgules d’un ou plusieurs rôles actuellement disponibles (la liste complète se trouve dans l’objet roles de la réponse de l’API). | string | Non | ?role=developer |
| product | Liste séparée par des virgules d’un ou plusieurs rôles actuellement disponibles (la liste complète se trouve dans l’objet products de la réponse de l’API). L’API ne prend pas en charge la hiérarchie des produits. Ajoutez donc chaque produit à la liste que vous souhaitez inclure dans votre requête. | string | No | ?product=azure |
| subject | Liste séparée par des virgules d’un ou plusieurs rôles actuellement disponibles (la liste complète se trouve dans l’objet subjects de la réponse de l’API). L’API ne prend pas en charge la hiérarchie des sujets. Ajoutez donc chaque sujet à la liste que vous souhaitez inclure dans votre requête. | string | Non | ?subject=cloud-computing |
Exemples de requêtes
Les requêtes répertoriées ci-dessous sont des exemples. Elles vous aideront à avoir une idée de ce que vous pouvez demander et de la façon de former la requête.
| Description | Requête |
|---|---|
| Tous les éléments de l’API Catalogue Learn | https://learn.microsoft.com/api/catalog/ |
| Tous les modules espagnols | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Tous les modules avec un score de popularité de 0,9 ou supérieur | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Tous les objets de formation et de certification de sécurité pour débutants | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Tous les modules d’accessibilité avancés avec un score de popularité supérieur à 0,5 et mis à jour au cours du mois dernier | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
Réponse de l’API
Le service peut retourner les codes d’état HTTP suivants.
| Code d’état | Description |
|---|---|
| 200 | Opération réussie. Le corps de la réponse contient les données encodées en JSON. |
| 400 | L’un des paramètres de requête est manquant ou n’est pas valide. |
| 404 | L’URL est introuvable sur le serveur. |
| 500 | Erreur de serveur inattendue. |
| 503 | Le service est temporairement indisponible. |
Une réponse indiquant une opération réussie inclut des détails sur l’ensemble des modules et parcours d’apprentissage, comme indiqué ci-dessous.
Corps de réponse
Un corps de réponse réussi est encodé dans JSON et contient 12 sections :
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Chaque tableau possède un ou plusieurs objets encodés au format JSON contenant des données propres à cette section de la réponse.
modulesest un tableau de modules publiés.unitsest un tableau d’unités publiées.learningPathsest un tableau de parcours d’apprentissage publiés.appliedSkills: tableau de compétences appliquées publiées.mergedCertifications: tableau de certifications publiées fusionnées avec des examens.certificationsest un tableau de certifications publiées.examsest un tableau d’examens publiés.coursesest un ensemble de cours publiés dispensés par un instructeur.levelsest un tableau de niveaux de public visé possibles.productsest un ensemble de produits et services possibles couverts dans le catalogue.rolesest un tableau de rôles possibles.subjects: est un tableau de balises d’objet possibles.
Enregistrements de module
Enregistrements de module
Chaque enregistrement de module se présente sous la forme suivante :
{
"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
}
Détails du champ
| Champ | Type | Description |
|---|---|---|
summary |
chaîne | Chaîne qui fournit une brève description du module. La valeur est exprimée sous la forme d’une balise de paragraphe HTML avec le texte interne qui est le résumé. |
levels |
tableau de chaînes | Liste des niveaux associés à ce module, qui indiquent la quantité d’expérience nécessaire au rôle pour comprendre tous les aspects de ce module. Des détails sur les unités peuvent être référencés dans les enregistrements de niveaux. |
roles |
tableau de chaînes | Liste des fonctions auxquelles ce module s’applique. |
products |
tableau de chaînes | Liste des produits pertinents couverts par ce module. Des détails sur les produits peuvent être référencés dans les enregistrements de produits. |
subjects |
tableau de chaînes | Liste d’objets pertinents couverts par ce parcours d’apprentissage. |
uid |
chaîne | Identificateur unique pour ce module. Cette valeur est unique sur l’ensemble de MS Learn. |
type |
chaîne | Type d’enregistrement. La valeur est toujours « module ». |
title |
chaîne | Titre du module dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
duration_in_minutes |
entier | Temps moyen nécessaire au suivi de ce module, exprimé en minutes. |
rating |
object | Contient à la fois count, qui est le nombre de personnes ayant évalué le module et average, un agrégat des évaluations, qui sera de 1 à 5 |
popularity |
double | Valeur normalisée de 0 à 1 indiquant la popularité du module |
icon_url |
chaîne | URL complète d’une image SVG 100x100 qui représente l’image de réalisation du module avec un arrière-plan transparent. |
social_image_url |
string | URL complète d’une image PNG qui représente l’image de réalisation du module avec un arrière-plan rectangulaire opaque, adapté aux expériences de réseaux sociaux ou de vignettes. Si elle n’est pas disponible pour ce module, cette propriété n’est pas renvoyée dans la réponse. |
locale |
chaîne | Langage dans lequel ces données JSON sont écrites. Cette valeur correspond au paramètre régional demandé s’il est disponible, ou à « en-US » dans le cas contraire. |
last_modified |
date | Dernière fois que ce module a subi une révision majeure. |
url |
chaîne | URL complète du module Learn dans les paramètres régionaux demandés. |
firstUnitUrl |
string | URL complète de la première unité du module Learn dans les paramètres régionaux demandés. |
units |
tableau de chaînes | Liste des UID d’unité associés. Des détails sur les unités peuvent être référencés dans les enregistrements d’unités. |
number_of_children |
entier | Nombre de pages (unités) de ce module. |
Enregistrements d’unités
Chaque enregistrement d’unité se présente sous la forme suivante :
{
"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"
},
Notes
L’enregistrement d’unité n’a pas l’URL associée, car les unités ne sont pas écrites en tant que contenu autonome. Elles sont destinées à être utilisées dans un ordre spécifique pour le module. Pour cette raison, nous incluons le lien vers la page de détails du module et la première unité de l’enregistrement du module afin que les utilisateurs puissent démarrer à cet endroit-là et poursuivre la lecture du contenu. Toutefois, les enregistrements d’unité peuvent être utilisés pour obtenir des détails sur les unités à afficher dans les systèmes de gestion de l’apprentissage ou d’autres expériences.
Détails du champ
| Champ | Type | Description |
|---|---|---|
uid |
chaîne | Identificateur unique pour ce module. Cette valeur est unique sur l’ensemble de MS Learn. |
type |
chaîne | Type d’enregistrement. La valeur est toujours « unité ». |
title |
string | Titre de l’unité dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
duration_in_minutes |
Durée de l’unité. Si vous ajoutez toutes les durées en minutes des unités associées à chaque module, vous obtiendrez la durée totale du module. | |
locale |
chaîne | Langage dans lequel ces données JSON sont écrites. Cette valeur correspond au paramètre régional demandé s’il est disponible, ou à « en-US » dans le cas contraire. |
last_modified |
date | Dernière fois que ce module a subi une révision majeure. |
Enregistrements de parcours d’apprentissage
Chaque enregistrement de parcours d’apprentissage se présente sous la forme suivante :
{
"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
}
Détails du champ
| Champ | Type | Description |
|---|---|---|
summary |
chaîne | Chaîne qui fournit une brève description du parcours d’apprentissage. La valeur est exprimée sous la forme d’une balise de paragraphe HTML avec le texte interne qui est le résumé. |
levels |
tableau de chaînes | Liste des niveaux associés à ce parcours d'apprentissage, qui indiquent la quantité d’expérience nécessaire au rôle pour comprendre tous les aspects de ce parcours d'apprentissage. Des détails sur les unités peuvent être référencés dans les enregistrements de niveaux. |
roles |
tableau de chaînes | Liste des rôles appropriés pour ce parcours d’apprentissage. |
products |
tableau de chaînes | Liste des produits pertinents couverts par ce parcours d’apprentissage. Des détails sur les produits peuvent être référencés dans les enregistrements de produits. |
subjects |
tableau de chaînes | Liste d’objets pertinents couverts par ce parcours d’apprentissage. |
uid |
chaîne | Identificateur unique pour ce parcours d’apprentissage. Cette valeur est unique sur l’ensemble de MS Learn. |
type |
chaîne | Type d’enregistrement. La valeur est toujours « learningPath ». |
title |
chaîne | Titre du parcours d’apprentissage dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
duration_in_minutes |
entier | Temps moyen nécessaire au suivi de ce parcours d’apprentissage, exprimé en minutes. Cette valeur est une somme des données de tous les modules inclus. |
rating |
object | Contient à la fois count, qui est le nombre de personnes ayant évalué le parcours d'apprentissage et average, un agrégat des évaluations, qui sera de 1 à 5 |
popularity |
double | Valeur normalisée de 0 à 1 indiquant la popularité du parcours d'apprentissage |
icon_url |
chaîne | URL complète d’une image SVG 100 x 100 qui représente le parcours d’apprentissage. |
social_image_url |
string | URL complète d’une image PNG qui représente l’image de réalisation du parcours d’apprentissage avec un arrière-plan rectangulaire opaque, adapté aux expériences de réseaux sociaux ou de vignettes. Si elle n’est pas disponible pour ce module, cette propriété n’est pas renvoyée dans la réponse. |
locale |
chaîne | Langage dans lequel ces données JSON sont écrites. Cette valeur correspond au paramètre régional demandé s’il est disponible, ou à « en-US » dans le cas contraire. |
last_modified |
date | Date de dernière modification de ce parcours d’apprentissage. |
url |
chaîne | URL complète du parcours d’apprentissage dans Microsoft Learn dans les paramètres régionaux demandés. |
firstModuleUrl |
string | URL complète du premier module du parcours d'apprentissage dans Microsoft Learn dans les paramètres régionaux demandés. |
modules |
tableau de chaînes | Liste des UID de module associés. Des détails sur les modules peuvent être référencés dans les enregistrements de module. |
number_of_children |
entier | Nombre de modules dans ce parcours d’apprentissage. |
Enregistrements de compétences appliqués
Chaque enregistrement de compétences appliquées aura la forme suivante :
{
"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"
}
Détails du champ
| Champ | Type | Description |
|---|---|---|
uid |
string | Identificateur unique pour cette compétence appliquée : cette valeur sera unique dans l’ensemble de MS Learn. |
locale |
string | Langage dans lequel ces données JSON sont écrites. Cette valeur correspond au paramètre régional demandé s’il est disponible, ou à « en-US » dans le cas contraire. |
title |
string | Titre de la compétence appliquée dans les paramètres régionaux demandés, ou en anglais américain par défaut. |
summary |
string | Résumé de la compétence appliquée dans les paramètres régionaux demandés, ou en anglais américain par défaut. |
url |
string | URL complète de la compétence appliquée dans Microsoft Learn dans les paramètres régionaux demandés. |
icon_url |
string | URL complète vers une image SVG 100 x 100 qui représente la compétence appliquée (lorsqu’elle est disponible, sinon non incluse). |
levels |
tableau de chaînes | Liste des niveaux associés à cette compétence appliquée. |
roles |
tableau de chaînes | Liste des rôles de travail pertinents pour cette compétence appliquée. Des détails sur les rôles peuvent être référencés dans les enregistrements de rôle. |
subjects |
tableau de chaînes | Liste des sujets pertinents abordés par cette compétence appliquée. |
study_guide |
tableau d’objets | Liste du contenu associé à étudier pour cette compétence appliquée. Des détails sur les objets peuvent être référencés dans les enregistrements associés. |
last_modified |
date | La dernière fois que cette compétence appliquée a été modifiée. |
Enregistrements de certification fusionnés
Chaque enregistrement de certification fusionné aura la forme suivante :
{
"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": []
}
Détails du champ
| Champ | Type | Description |
|---|---|---|
uid |
string | Identificateur unique pour cette certification. Cette valeur est unique sur l’ensemble de MS Learn. |
title |
string | Titre de la certification dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
summary |
string | Résumé de la certification dans les paramètres régionaux demandés, ou en anglais américain par défaut. |
url |
string | URL complète de la certification dans Microsoft Learn dans les paramètres régionaux demandés. |
icon_url |
string | URL complète d’une image SVG 100 x 100 qui représente la certification. |
last_modified |
date | La dernière fois que cette certification a été modifiée. |
type |
string | Type d’enregistrement. La valeur est toujours « cert ». |
certification_type |
string | Type de certification. Les valeurs possibles sont 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
products |
tableau de chaînes | Liste des produits pertinents couverts par cette certification. Des détails sur les produits peuvent être référencés dans les enregistrements de produits. |
levels |
tableau de chaînes | Liste des niveaux associés à cette certification, qui indiquent la quantité d’expérience nécessaire au rôle pour comprendre tous les aspects de cette certification. Des détails sur les unités peuvent être référencés dans les enregistrements de niveaux. |
roles |
tableau de chaînes | Liste des rôles appropriés pour cette certification. Des détails sur les rôles peuvent être référencés dans les enregistrements de rôle. |
subjects |
tableau de chaînes | Liste des sujets pertinents abordés par cette certification. |
renewal_frequency_in_days |
entier | Nombre de jours avant l’expiration de cette certification et son renouvellement obligatoire. Si la valeur est 0, la certification n’expire pas. |
prerequisites |
tableau de chaînes | Liste des conditions préalables recommandées pour obtenir cette certification. Des détails sur les certifications peuvent être référencés dans les enregistrements de certification. |
skills |
tableau de chaînes | Liste des compétences mesurées sur l’examen requis pour cette certification. |
recommendation_list |
tableau de chaînes | Liste des recommandations relatives à cette certification. |
study_guide |
tableau d’objets | Liste du contenu associé à étudier pour cette certification. Des détails sur les objets peuvent être référencés dans les enregistrements associés. |
exam_duration_in_minutes |
entier | Nombre de minutes allouées pour terminer l’examen. |
locales |
tableau de chaînes | Liste des langues dans lesquelles cette certification est proposée. |
providers |
tableau d’objets | Liste des fournisseurs pour cette certification. Le type décrit le fournisseur et une URL complète avec un lien pour planifier un examen avec le fournisseur. |
career_paths |
tableau d’objets | Liste des parcours de carrière pour cette certification. |
Remarque
Les certifications qui ne nécessitent qu’un seul examen seront retournées dans le cadre de cette propriété mergedCertifications.
Enregistrements de certification
Chaque enregistrement de certification se présente sous la forme suivante :
{
"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"
}
]
}
Détails du champ
| Champ | Type | Description |
|---|---|---|
uid |
string | Identificateur unique pour cette certification. Cette valeur est unique sur l’ensemble de MS Learn. |
title |
string | Titre de la certification dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
subtitle |
string | Sous-titre de la certification dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
url |
string | URL complète de la certification dans Microsoft Learn dans les paramètres régionaux demandés. |
icon_url |
string | URL complète d’une image SVG 100 x 100 qui représente la certification. |
type |
chaîne | Type d’enregistrement. La valeur est toujours « cert ». |
certification_type |
string | Type de certification. Les valeurs possibles sont 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
exams |
tableau de chaînes | Liste des examens associés requis pour cette certification. Des détails sur les unités peuvent être référencés dans les enregistrements de certifications. |
levels |
tableau de chaînes | Liste des niveaux associés à cette certification, qui indiquent la quantité d’expérience nécessaire au rôle pour comprendre tous les aspects de cette certification. Des détails sur les unités peuvent être référencés dans les enregistrements de niveaux. |
roles |
tableau de chaînes | Liste des rôles appropriés pour cette certification. Des détails sur les rôles peuvent être référencés dans les enregistrements de rôle. |
study_guide |
tableau d’objets | Liste du contenu associé à étudier pour cette certification. Des détails sur les objets peuvent être référencés dans les enregistrements associés. |
Remarque
Les certifications nécessitant plusieurs examens seront présentes dans cet enregistrement de certifications référençant le tableau des examens.
Enregistrements d’examens
Chaque enregistrement d’examen se présente sous la forme suivante :
{
"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&utm_medium=certpage&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"
}
]
}
Détails du champ
| Champ | Type | Description |
|---|---|---|
uid |
string | Identificateur unique pour cet examen. Cette valeur est unique sur l’ensemble de MS Learn. |
title |
string | Titre de l’examen dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
subtitle |
string | Sous-titre de l’examen dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
display_name |
string | Nom d’affichage de l’examen dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
url |
string | URL complète de l’examen dans Microsoft Learn dans les paramètres régionaux demandés. |
icon_url |
string | URL complète d’une image SVG 100 x 100 qui représente l’examen. |
pdf_download_url |
string | URL complète vers le PDF décrivant les compétences mesurées par cet examen. |
practice_test_url |
string | URL complète vers un test de pratique associé à l’examen. |
practice_assessment_url |
string | URL complète vers une évaluation pratique gratuite associé à l’examen. |
locales |
tableau de chaînes | Liste des langues dans lesquelles cet examen est proposé. |
type |
chaîne | Type d’enregistrement. La valeur est toujours « exam ». |
courses |
tableau de chaînes | Liste des UID de cours associés. Les détails relatifs aux cours peuvent être référencés dans les enregistrements de cours. |
levels |
tableau de chaînes | Liste des niveaux associés à cet examen, qui indiquent la quantité d’expérience nécessaire au rôle pour comprendre tous les aspects de cet examen. Des détails sur les unités peuvent être référencés dans les enregistrements de niveaux. |
roles |
tableau de chaînes | Liste des rôles appropriés pour cet examen. Des détails sur les rôles peuvent être référencés dans les enregistrements de rôle. |
products |
tableau de chaînes | Liste des produits pertinents couverts par cet examen. Des détails sur les produits peuvent être référencés dans les enregistrements de produits. |
providers |
tableau d’objets | Liste des fournisseurs pour cet examen. Le type décrit le fournisseur et une URL complète avec un lien pour planifier un examen avec le fournisseur. |
study_guide |
tableau d’objets | Liste du contenu associé à étudier pour cet examen. Des détails sur les objets peuvent être référencés dans les enregistrements associés. |
Enregistrements de cours dispensés par un instructeur
Chaque enregistrement de cours se présente sous la forme suivante :
{
"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"
}
]
},
Détails du champ
| Champ | Type | Description |
|---|---|---|
uid |
string | Identificateur unique pour ce cours dispensé par un instructeur. Cette valeur est unique sur l’ensemble de MS Learn. |
course_number |
string | Identificateur du numéro de cours dispensé par un instructeur. |
title |
string | Titre du cours dispensé par un instructeur dans les paramètres régionaux demandés, ou anglais (États-Unis) comme langue secondaire. |
summary |
string | Chaîne qui fournit une brève description du cours dispensé par un instructeur. La valeur est exprimée sous la forme d’une balise de paragraphe HTML avec le texte interne qui est le résumé. |
duration_in_hours |
entier | Temps moyen nécessaire à ce cours dispensé par un instructeur, exprimé en heures. |
url |
string | URL complète de la page de détails du cours dispensé par un instructeur dans Microsoft Learn dans les paramètres régionaux demandés. |
icon_url |
string | URL complète d’une image SVG 100x100 qui représente la réussite du cours dispensé par un instructeur. |
locales |
tableau de chaînes | Liste des langues dans lesquelles ce cours dispensé par un instructeur est officiellement proposé. D’autres langues peuvent être prises en charge par les partenaires de formation. |
type |
chaîne | Type d’enregistrement. La valeur sera toujours « course » pour les cours dispensés par un instructeur. |
certification |
string | Certification associée au cours dispensé par un instructeur. |
exam |
string | Examen associé au cours dispensé par un instructeur. |
levels |
tableau de chaînes | Liste des niveaux associés à ce cours dispensé par un instructeur, qui indiquent la quantité d’expérience nécessaire au rôle pour comprendre tous les aspects de ce cours dispensé par un instructeur. Des détails sur les unités peuvent être référencés dans les enregistrements de niveaux. |
study_guide |
tableau d’objets | URL complète vers le PDF décrivant les compétences mesurées par cette certification. |
Enregistrements de niveau, de produit, de rôle et d’objet
Les collections levels, products, roles et subjects fournissent des noms conviviaux pour les valeurs utilisées dans les données de module et de parcours d’apprentissage. Les quatre collections ont la même forme :
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
L’ID id correspond aux valeurs des niveaux, des produits, des rôles et des objets inclus dans les autres entrées du catalogue. Le name associé fournit un nom approprié en anglais pour l’entrée. Le tableau children est facultatif et permet de hiérarchiser les valeurs qui ont des relations enfants, telles que les produits.
À titre d’exemple, voici un ensemble de rôles possibles :
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
Voici un exemple de jeu de produits, avec des enfants inclus pour fournir une catégorie de produit plus spécifique.
{
...
"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"
},
...
]
}
Exemples de code
Il existe de nombreuses façons d’appeler l’API Catalog de Learn, mais voici des exemples de code montrant comment elle peut être utilisée.
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 utilisant l’extension cURL
<?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 utilisant la bibliothèque « requests »
#!/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)
Étapes suivantes
Consultez revue les ressources ci-dessous pour vous faciliter votre parcours de développement :