Documentación de la API de catálogo de Microsoft Learn para desarrolladores
En este artículo se proporciona información para desarrolladores y solicitantes que implementan la API de catálogo de Microsoft Learn. También se recomienda consultar los artículos sobre los procedimientos recomendados, las notas de la versión y las preguntas más frecuentes de la API de catálogo de Learn como ayuda en su recorrido de desarrollo.
Punto de conexión de la API
La API de catálogo de Microsoft Learn es una API web basada en REST que devuelve una respuesta codificada en JSON. Para solicitar el catálogo completo, envíe una solicitud GET a:
https://learn.microsoft.com/api/catalog/
Nota
El punto de conexión que aquí se indica es el actual. Si usa un punto de conexión anterior diferente, seguirá funcionando según lo previsto cuando se incorporó, pero la ventaja de cambiar al nuevo punto de conexión es que proporciona características mejoradas, como parámetros de consulta adicionales.
Parámetros de consulta
A continuación se indican los parámetros de consulta que puede incluir la solicitud. Todos son opcionales. Debe codificar los valores de los parámetros de consulta como una dirección URL. Puede usar el punto de conexión con ninguno, uno, algunos o todos estos parámetros.
Importante
Si usa más de uno, la consulta se evalúa con el operador Y.
| Nombre | Value | Tipo | Obligatorio | Ejemplo |
|---|---|---|---|---|
| locale | Código de configuración regional válido de la lista de configuraciones regionales admitidas. Los metadatos devueltos estarán en la configuración regional solicitada, si está disponible. Si no se proporciona este parámetro, se devuelve la respuesta en-us. |
string | No | ?locale=en-us |
| type | Lista separada por comas de uno o varios de los objetos de contenido o taxonomía de nivel superior que se proporcionan actualmente en la respuesta que se devuelve. Los valores admitidos son: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects. |
cadena | No | ?type=modules,learningPaths |
| uid | Lista separada por comas de uno o varios identificadores únicos (uid) de contenido válidos de los tipos de contenido disponibles. Nota: Los uid distinguen mayúsculas de minúsculas. | string | No | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | Operador y valor de fecha y hora para filtrar por la fecha de última modificación de los objetos. El operador puede ser lt (menor que), lte (menor o igual que), eq (igual a), gt (mayor que), gte (mayor o igual que). Cuando se usa este parámetro, si no se especifica el operador, se usa gte de forma predeterminada. |
string | No | ?last_modified=gte 2022-01-01 |
| popularity | Operador y valor para filtrar por el valor de popularidad (en un intervalo de 0-1) de los objetos. El operador puede ser lt (menor que), lte (menor o igual que), eq (igual a), gt (mayor que), gte (mayor o igual que). Cuando se usa este parámetro, si no se especifica el operador, se usa gte de forma predeterminada. |
string | No | ?popularity=gte 0.5 |
| level | Lista separada por comas de uno o varios de los niveles disponibles actualmente (la lista completa está en el objeto levels de la respuesta de la API). | string | No | ?level=beginner |
| rol | Lista separada por comas de uno o varios de los roles disponibles actualmente (la lista completa está en el objeto roles de la respuesta de la API). | string | No | ?role=developer |
| product | Lista separada por comas de uno o varios de los productos disponibles actualmente (la lista completa está en el objeto products de la respuesta de la API). La API no admite la jerarquía de productos; por tanto, agregue a la lista todos los productos que desee incluir en la consulta. | string | No | ?product=azure |
| subject | Lista separada por comas de uno o varios de los temas disponibles actualmente (la lista completa está en el objeto subjects de la respuesta de la API). La API no admite la jerarquía de temas; por tanto, agregue a la lista todos los temas que desee incluir en la consulta. | string | No | ?subject=cloud-computing |
Consultas de ejemplo
Las siguientes consultas son ejemplos que le ayudarán a hacerse una idea de lo que puede solicitar y cómo crear la solicitud.
| Descripción | Consultar |
|---|---|
| Todos los elementos de la API de catálogo de Learn | https://learn.microsoft.com/api/catalog/ |
| Todos los módulos en español | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Todos los módulos con una puntuación de popularidad de 0,9 o superior | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Todos los objetos de aprendizaje y certificación sobre seguridad para principiantes | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Todos los módulos avanzados sobre accesibilidad con una puntuación de popularidad superior a 0,5 y actualizados en el último mes | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
Respuesta de la API
El servicio puede devolver los siguientes códigos de estado HTTP.
| Código de estado | Descripción |
|---|---|
| 200 | Correcto. El cuerpo de la respuesta incluye los datos codificados en JSON. |
| 400 | Falta uno de los parámetros de consulta o no es válido. |
| 404 | No se encontró la dirección URL en el servidor. |
| 500 | Error inesperado del servidor. |
| 503 | El servicio no está disponible temporalmente. |
Una respuesta correcta incluirá los detalles de todos los módulos y rutas de aprendizaje, como se muestra a continuación.
Cuerpo de la respuesta
Un cuerpo de respuesta correcto se codificará en JSON y tendrá 12 secciones:
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Cada matriz tiene uno o varios objetos codificados en JSON que contienen datos específicos de esa sección de la respuesta.
modules: es una matriz de los módulos publicados.units: es una matriz de las unidades publicadas.learningPaths: es una matriz de las rutas de aprendizaje publicadas.appliedSkills: es una matriz de aptitudes aplicadas publicadas.mergedCertifications: es una matriz de certificaciones publicadas combinadas con exámenes.certifications: es una matriz de las certificaciones publicadas.exams: es una matriz de los exámenes publicados.courses: es una matriz de los cursos dirigidos por un instructor publicados.levels: es una matriz de posibles niveles de audiencia.products: es una matriz de posibles productos y servicios cubiertos en el catálogo.roles: es una matriz de posibles roles.subjects: es una matriz de etiquetas de temas posibles.
Registros de módulo
Registros de módulo
Cada registro de módulo tiene el siguiente formato:
{
"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
}
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
summary |
Cadena | Cadena que proporciona una breve descripción del módulo. El valor se expresa como una etiqueta de párrafo HTML cuyo texto interno es el resumen. |
levels |
Matriz de cadenas | Lista de los niveles asociados a este módulo, que indican cuánta experiencia en el rol es necesaria para comprender todos los aspectos de este módulo. Los detalles sobre las unidades se pueden consultar en los registros de nivel. |
roles |
Matriz de cadenas | Lista de los roles con los que está relacionado este módulo. |
products |
Matriz de cadenas | Lista de productos relevantes que se tratan en este módulo. Los detalles sobre los productos se pueden consultar en los registros de producto. |
subjects |
Matriz de cadenas | Lista de temas relevantes que se tratan en esta ruta de aprendizaje. |
uid |
Cadena | Identificador único para este módulo. Este valor será único en todo Microsoft Learn. |
type |
Cadena | Tipo de registro. El valor será siempre “module”. |
title |
Cadena | Título del módulo en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
duration_in_minutes |
Entero | Tiempo medio que se tarda en realizar este módulo. |
rating |
object | Contiene count, que es el número de personas que han valorado el módulo, y average, un agregado de las valoraciones, comprendido entre 1 y 5. |
popularity |
double | Valor normalizado de 0-1 que indica la popularidad del módulo. |
icon_url |
Cadena | Dirección URL completa de una imagen SVG de 100 x 100 px que representa la imagen de logro del módulo con un fondo transparente. |
social_image_url |
string | Dirección URL completa de una imagen PNG que representa la imagen de logro del módulo con un fondo rectangular opaco, adecuado para las experiencias de icono o redes sociales. Si esta propiedad no está disponible para este módulo, no se devuelve en la respuesta. |
locale |
Cadena | Idioma en el que se escriben los datos JSON. Este valor será la configuración regional solicitada si está disponible o “en-US” si no lo está. |
last_modified |
Fecha | Última vez que se hizo una revisión importante de este módulo. |
url |
Cadena | Dirección URL completa del módulo de Learn en la configuración regional solicitada. |
firstUnitUrl |
string | Dirección URL completa de la primera unidad del módulo de Learn en la configuración regional solicitada. |
units |
Matriz de cadenas | Lista de los UID de unidad asociados. Los detalles sobre las unidades se pueden consultar en los registros de unidad. |
number_of_children |
Entero | Número de páginas (unidades) que contiene este módulo. |
Registros de unidad
Cada registro de unidad tiene el siguiente formato:
{
"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"
},
Nota
El registro de unidad no tiene la dirección URL asociada porque las unidades no se escriben como contenido independiente. Están diseñadas para estudiarlas en un orden específico para el módulo. Por este motivo, se incluye el vínculo a la página de detalles del módulo y la primera unidad del registro del módulo para que los usuarios puedan empezar ahí y continuar con el contenido. No obstante, los registros de unidad se pueden usar para obtener detalles sobre las unidades que se muestran en los sistemas de administración de aprendizaje (LMS) u otras experiencias.
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
uid |
Cadena | Identificador único para este módulo. Este valor será único en todo Microsoft Learn. |
type |
Cadena | Tipo de registro. El valor será siempre “unit”. |
title |
string | Título de la unidad en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
duration_in_minutes |
Duración de la unidad. Si suma todos los valores de duration_in_minutes de las unidades asociadas a cada módulo, obtiene la duración total del módulo. | |
locale |
Cadena | Idioma en el que se escriben los datos JSON. Este valor será la configuración regional solicitada si está disponible o “en-US” si no lo está. |
last_modified |
Fecha | Última vez que se hizo una revisión importante de este módulo. |
Registros de ruta de aprendizaje
Cada ruta de aprendizaje tiene el siguiente formato:
{
"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
}
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
summary |
Cadena | Cadena que proporciona una breve descripción de la ruta de aprendizaje. El valor se expresa como una etiqueta de párrafo HTML cuyo texto interno es el resumen. |
levels |
Matriz de cadenas | Lista de los niveles asociados a esta ruta de aprendizaje, que indican cuánta experiencia en el rol es necesaria para comprender todos los aspectos de esta ruta de aprendizaje. Los detalles sobre las unidades se pueden consultar en los registros de nivel. |
roles |
Matriz de cadenas | Lista de los roles con los que está relacionada esta ruta de aprendizaje. |
products |
Matriz de cadenas | Lista de productos relevantes que se tratan en esta ruta de aprendizaje. Los detalles sobre los productos se pueden consultar en los registros de producto. |
subjects |
Matriz de cadenas | Lista de temas relevantes que se tratan en esta ruta de aprendizaje. |
uid |
Cadena | Identificador único para esta ruta de aprendizaje. Este valor será único en todo Microsoft Learn. |
type |
Cadena | Tipo de registro. El valor será siempre “learningPath”. |
title |
Cadena | Título de la ruta de aprendizaje en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
duration_in_minutes |
Entero | Tiempo medio que se tarda en realizar esta ruta de aprendizaje. Este valor es la suma de los datos de todos los módulos incluidos. |
rating |
object | Contiene count, que es el número de personas que han valorado la ruta de aprendizaje, y average, un agregado de las valoraciones, comprendido entre 1 y 5. |
popularity |
double | Valor normalizado de 0-1 que indica la popularidad de la ruta de aprendizaje. |
icon_url |
Cadena | Dirección URL completa de una imagen SVG de 100 x 100 px que representa la ruta de aprendizaje. |
social_image_url |
string | Dirección URL completa de una imagen PNG que representa la imagen de logro de la ruta de aprendizaje con un fondo rectangular opaco, adecuado para las experiencias de icono o redes sociales. Si esta propiedad no está disponible para este módulo, no se devuelve en la respuesta. |
locale |
Cadena | Idioma en el que se escriben los datos JSON. Este valor será la configuración regional solicitada si está disponible o “en-US” si no lo está. |
last_modified |
Fecha | Última vez que se modificó esta ruta de aprendizaje. |
url |
Cadena | Dirección URL completa de la ruta de aprendizaje en Microsoft Learn en la configuración regional solicitada. |
firstModuleUrl |
string | Dirección URL completa del primer módulo de la ruta de aprendizaje en Microsoft Learn en la configuración regional solicitada. |
modules |
Matriz de cadenas | Lista de los UID de módulo asociados. Los detalles sobre los módulos se pueden consultar en los registros de módulo. |
number_of_children |
Entero | Número de módulos que incluye esta ruta de aprendizaje. |
Registros de aptitudes aplicadas
Cada registro de aptitudes aplicadas tendrá el siguiente formato:
{
"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"
}
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
uid |
cadena | Un identificador único para esta aptitud aplicada: este valor será único en todas las instancias de MS Learn. |
locale |
cadena | Idioma en el que se escriben los datos JSON. Este valor será la configuración regional solicitada si está disponible o “en-US” si no lo está. |
title |
cadena | Título de la aptitud aplicada en la configuración regional solicitada o inglés de EE. UU., en caso que no se indique. |
summary |
cadena | Resumen de la aptitud aplicada en la configuración regional solicitada o inglés de EE. UU., en caso que no se indique. |
url |
cadena | Dirección URL completa de la aptitud aplicada en Microsoft Learn en la configuración regional solicitada. |
icon_url |
cadena | Dirección URL completa a una imagen SVG de 100x100 que representa la aptitud aplicada (cuando está disponible; de lo contrario, no se incluye). |
levels |
Matriz de cadenas | Lista de los niveles asociados a esta aptitud aplicada. |
roles |
Matriz de cadenas | Lista de los roles de trabajo pertinentes para esta aptitud aplicada. Los detalles sobre los roles se pueden consultar en los registros de rol. |
subjects |
Matriz de cadenas | Una lista de los temas pertinentes que aborda esta aptitud aplicada. |
study_guide |
matriz de objetos | Lista del contenido asociado que se va a estudiar para esta aptitud aplicada. Los detalles sobre los objetos se pueden consultar en los registros asociados. |
last_modified |
date | La última vez que se cambió esta aptitud aplicada. |
Registros de certificación combinados
Cada registro de certificación combinado tendrá el siguiente formato:
{
"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": []
}
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
uid |
string | Identificador único para esta ruta certificación. Este valor será único en todo Microsoft Learn. |
title |
string | Título de la certificación en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
summary |
cadena | Resumen de la certificación en la configuración regional solicitada o inglés de EE. UU., en caso que no se indique. |
url |
cadena | Dirección URL completa de la certificación en Microsoft Learn en la configuración regional solicitada. |
icon_url |
string | Dirección URL completa de una imagen SVG de 100 x 100 px que representa la certificación. |
last_modified |
date | La última vez que se cambió esta certificación. |
type |
cadena | Tipo de registro. El valor será siempre “cert”. |
certification_type |
string | Tipo de certificación. Los valores posibles son “fundamentals”, “mce”, “mcsa”, “mcsd”, “mcse”, “mos”, “mta”, “role-based”, “specialty”. |
products |
Matriz de cadenas | Una lista de los productos pertinentes que aborda esta certificación. Los detalles sobre los productos se pueden consultar en los registros de producto. |
levels |
Matriz de cadenas | Lista de los niveles asociados a esta certificación, que indican cuánta experiencia en el rol es necesaria para comprender todos los aspectos de esta certificación. Los detalles sobre las unidades se pueden consultar en los registros de nivel. |
roles |
Matriz de cadenas | Lista de los roles con los que está relacionada esta certificación. Los detalles sobre los roles se pueden consultar en los registros de rol. |
subjects |
Matriz de cadenas | Una lista de temas pertinentes que aborda esta certificación. |
renewal_frequency_in_days |
integer | El número de días antes de que expire esta certificación y deba renovarse. Si el valor es 0, la certificación no expira. |
prerequisites |
Matriz de cadenas | Una lista de los requisitos previos recomendados para obtener esta certificación. Se puede hacer referencia a los detalles sobre las certificaciones en los registros de certificación. |
skills |
Matriz de cadenas | Una lista de las aptitudes que se miden en el examen necesario para esta certificación. |
recommendation_list |
Matriz de cadenas | Una lista de las recomendaciones relacionadas con esta certificación. |
study_guide |
matriz de objetos | Lista del contenido asociado que se estudia para esta certificación. Los detalles sobre los objetos se pueden consultar en los registros asociados. |
exam_duration_in_minutes |
integer | Número de minutos asignados para completar el examen. |
locales |
Matriz de cadenas | Una lista de los idiomas en los que se ofrece esta certificación. |
providers |
matriz de objetos | Lista de proveedores para esta certificación. El tipo describe el proveedor y una dirección URL completa con un vínculo para programar un examen con el proveedor. |
career_paths |
matriz de objetos | Lista de rutas profesionales tras la obtención de esta certificación. |
Nota:
Las certificaciones que solo requieren un examen se devolverán como parte de esta propiedad mergedCertifications.
Registros de certificación
Cada registro de certificación tiene el siguiente formato:
{
"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"
}
]
}
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
uid |
string | Identificador único para esta ruta certificación. Este valor será único en todo Microsoft Learn. |
title |
string | Título de la certificación en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
subtitle |
string | Subtítulo de la certificación en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
url |
string | Dirección URL completa de la certificación en Microsoft Learn en la configuración regional solicitada. |
icon_url |
string | Dirección URL completa de una imagen SVG de 100 x 100 px que representa la certificación. |
type |
Cadena | Tipo de registro. El valor será siempre “cert”. |
certification_type |
string | Tipo de certificación. Los valores posibles son “fundamentals”, “mce”, “mcsa”, “mcsd”, “mcse”, “mos”, “mta”, “role-based”, “specialty”. |
exams |
Matriz de cadenas | Lista de los exámenes asociados necesarios para esta certificación. Los detalles sobre las unidades se pueden consultar en los registros de certificación. |
levels |
Matriz de cadenas | Lista de los niveles asociados a esta certificación, que indican cuánta experiencia en el rol es necesaria para comprender todos los aspectos de esta certificación. Los detalles sobre las unidades se pueden consultar en los registros de nivel. |
roles |
Matriz de cadenas | Lista de los roles con los que está relacionada esta certificación. Los detalles sobre los roles se pueden consultar en los registros de rol. |
study_guide |
matriz de objetos | Lista del contenido asociado que se estudia para esta certificación. Los detalles sobre los objetos se pueden consultar en los registros asociados. |
Nota:
Las certificaciones que requieren más de un examen estarán presentes en este registro de certificaciones que hace referencia a la matriz de exámenes.
Registros de examen
Cada registro de examen tiene el siguiente formato:
{
"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"
}
]
}
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
uid |
string | Identificador único para este examen. Este valor será único en todo Microsoft Learn. |
title |
string | Título del examen en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
subtitle |
string | Subtítulo del examen en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
display_name |
string | Nombre para mostrar del examen en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
url |
string | Dirección URL completa del examen en Microsoft Learn en la configuración regional solicitada. |
icon_url |
string | Dirección URL completa de una imagen SVG de 100 x 100 px que representa el examen. |
pdf_download_url |
string | Dirección URL completa del archivo PDF donde se indican las aptitudes que se miden con este examen. |
practice_test_url |
string | Dirección URL completa de una prueba práctica asociada al examen. |
practice_assessment_url |
string | Dirección URL completa de una evaluación práctica gratuita asociada al examen. |
locales |
Matriz de cadenas | Lista de los idiomas en los que se ofrece este examen. |
type |
Cadena | Tipo de registro. El valor será siempre “exam”. |
courses |
Matriz de cadenas | Lista de los UID de cursos asociados. Los detalles sobre los cursos se pueden consultar en los registros de curso. |
levels |
Matriz de cadenas | Lista de los niveles asociados a este examen, que indican cuánta experiencia en el rol es necesaria para comprender todos los aspectos de este examen. Los detalles sobre las unidades se pueden consultar en los registros de nivel. |
roles |
Matriz de cadenas | Lista de los roles con los que está relacionado este examen. Los detalles sobre los roles se pueden consultar en los registros de rol. |
products |
Matriz de cadenas | Lista de productos relevantes que se tratan en este examen. Los detalles sobre los productos se pueden consultar en los registros de producto. |
providers |
matriz de objetos | Lista de proveedores de este examen. El tipo describe el proveedor y una dirección URL completa con un vínculo para programar un examen con el proveedor. |
study_guide |
matriz de objetos | Lista del contenido asociado que se estudia para este examen. Los detalles sobre los objetos se pueden consultar en los registros asociados. |
Registros de curso dirigido por un instructor
Cada registro de curso tiene el siguiente formato:
{
"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"
}
]
},
Detalles de los campos
| Campo | Tipo | Description |
|---|---|---|
uid |
string | Identificador único para este curso dirigido por un instructor. Este valor será único en todo Microsoft Learn. |
course_number |
string | Identificador numérico del curso dirigido por un instructor. |
title |
string | Título del curso dirigido por un instructor en la configuración regional solicitada o en inglés de Estados Unidos como segunda opción. |
summary |
string | Cadena que proporciona una breve descripción del curso dirigido por un instructor. El valor se expresa como una etiqueta de párrafo HTML cuyo texto interno es el resumen. |
duration_in_hours |
integer | Tiempo medio (en horas) que se tarda en completar este curso dirigido por un instructor. |
url |
string | Dirección URL completa de la página de detalles del curso dirigido por un instructor en Microsoft Learn en la configuración regional solicitada. |
icon_url |
string | Dirección URL completa de una imagen SVG de 100 x 100 px que representa el logro del curso dirigido por un instructor. |
locales |
Matriz de cadenas | Lista de idiomas en los que se ofrece oficialmente este curso dirigido por un instructor. Nuestros asociados de aprendizaje pueden ofrecerlo en otros idiomas. |
type |
Cadena | Tipo de registro. El valor será siempre "course" para los cursos dirigidos por un instructor. |
certification |
string | Certificación asociada al curso dirigido por un instructor. |
exam |
string | Examen asociado al curso dirigido por un instructor. |
levels |
Matriz de cadenas | Lista de los niveles asociados a este curso dirigido por un instructor, que indican cuánta experiencia en el rol es necesaria para comprender todos los aspectos de este curso dirigido por un instructor. Los detalles sobre las unidades se pueden consultar en los registros de nivel. |
study_guide |
matriz de objetos | Dirección URL completa del archivo PDF donde se indican las aptitudes que se miden con esta certificación. |
Registros de nivel, producto, rol y tema
Las colecciones levels, products, roles y subjects proporcionan nombres descriptivos de los valores utilizados en los datos de los módulos y las rutas de aprendizaje. Las cuatro colecciones tienen la misma forma:
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
El id coincidirá con los valores de los niveles, productos, roles y temas incluidos en las demás entradas del catálogo. El name asociado proporciona un nombre adecuado en inglés para la entrada. La matriz de children es opcional y permite una estructura jerárquíca para los valores que tienen relaciones secundarias, como los productos.
Por ejemplo, el siguiente es un conjunto de roles posibles:
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
Este es un conjunto de productos de ejemplo, con elementos secundarios incluidos para proporcionar una categoría de productos más específica.
{
...
"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"
},
...
]
}
Ejemplos de código
Hay muchas formas de llamar a la API de catálogo de Learn, pero los ejemplos de código siguientes muestran cómo se puede usar.
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 con la extensión 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 con la biblioteca "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)
Pasos siguientes
Consulte los siguientes recursos como ayuda para su recorrido de desarrollo: