Documentación de referencia de la API para desarrolladores de Learn Platform

En este artículo se proporciona información para desarrolladores e integradores que implementan microsoft Learn Platform API. También recomendamos consultar los artículos sobre la Información general de la API de la plataforma de Learn, las notas de versión, y las preguntas más frecuentes para apoyar tu camino de desarrollo.

Puntos de conexión de API

Los puntos de conexión del catálogo de API de la plataforma de Microsoft Learn son un conjunto de API web autenticadas basadas en REST que devuelven una respuesta codificada por JSON.

Los puntos de conexión son accesibles en:

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

Nota:

Si usa un punto de conexión diferente y anterior, seguirá funcionando según lo previsto hasta junio de 2026, en ese momento la API de catálogo no autenticada anterior comenzará su desuso. Si tiene más preguntas, póngase en contacto con LearnPlatformAPIMigration@microsoft.com.

Casos de uso

Autenticación

Las API REST de la plataforma de Learn usan el identificador de Entra de Microsoft para la autenticación. Antes de realizar llamadas API, debe elegir un método de acceso y la aplicación cliente debe autenticarse con credenciales válidas.

Acceso solo a aplicación

Cuando la aplicación accede directamente a Learn, su acceso no está vinculado a ningún usuario único. La aplicación llama a las API directamente utilizando su propia identidad; este escenario es de acceso exclusivo a la aplicación. Obtenga más información sobre la plataforma de identidad de Microsoft.

Para empezar, necesita una identidad válida en la Plataforma de identidad de Microsoft, que puede ser un registro de aplicación o una identidad administrada. Lo ideal es que cada asociado tenga una única identidad para simplificar la administración de cuotas y asociados. El uso de una identidad administrada asignada por el usuario puede ayudar a unificar las identidades administradas en distintos servicios.

Una vez configurada la identidad de Entra ID, obtenga un token de acceso de Entra ID con el ámbito establecido a https://learn.microsoft.com/.default como prueba de autenticación. Incluya el token de acceso en el encabezado de autorización HTTP al realizar solicitudes de API REST a Learn.

Acceso delegado

Cuando un usuario inicia sesión en la aplicación y lo usa para acceder a Learn, la aplicación primero deberá solicitar permiso para acceder a este recurso en nombre del usuario. Este escenario se denomina acceso delegado. Obtenga más información sobre la plataforma de identidad de Microsoft.

Para empezar, debe registrar un registro de aplicaciones. Una vez configurado el registro de la aplicación, la aplicación debe pedir al usuario que conceda un ámbito específico o un conjunto de ámbitos para acceder a Learn en nombre del usuario. Learn proporciona una lista de ámbitos para el acceso específico a los recursos. La lista de ámbitos incluye:

• https://learn.microsoft.com/PublicContent.Read.All: este alcance permite a los usuarios acceder al contenido público en Learn actuando como el usuario que ha iniciado sesión.

Parámetros de consulta

A continuación se muestran los parámetros de consulta que puede incluir la solicitud. Solo se requiere api-version y la versión actual es 2023-11-01-preview. Debe codificar con URL los valores del parámetro de consulta. Puede usar el punto de conexión con uno, algunos o todos estos parámetros.

Importante

Si usa más de una, la consulta se evalúa mediante el operador AND; los valores delimitados por comas dentro de un filtro se combinan con OR.

Nombre	Importancia	Tipo	Obligatorio	Example
versión de la API	La versión de la API se especifica como parámetro de consulta api-version y usa aaaa-MM-dd para versiones estables y aaaa-MM-dd-preview para versiones preliminares. El parámetro de consulta api-version es necesario para cada solicitud de API.	cuerda / cadena	Sí	?api-version=2023-11-01-preview
locale	Código local único y válido de la lista de localidades admitidas. Los metadatos devueltos estarán en la configuración regional solicitada, si está disponible. Si no se proporciona este parámetro, se devolverá la en-us respuesta.	cuerda / cadena	No	?locale=en-us
id	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 entre mayúsculas y minúsculas.	cuerda / cadena	No	?uid=learn.azure.intro-to-azure-fundamentals
updatedAt.gt	Operador y valor de fecha y hora para filtrar por la fecha de última modificación de los objetos. El operador incluye gt (mayor que), gte (mayor o igual que). Cuando se usa este parámetro, el operador tendrá como valor predeterminado gt si no se especifica.	cuerda / cadena	No	?updatedAt.gt=2022-01-01
niveles	Una lista separada por comas de uno o varios de los niveles que tenemos actualmente disponibles (la lista completa se encuentra en el objeto levels de la respuesta de la API).	cuerda / cadena	No	?levels=beginner
roles	Una lista separada por comas de uno o varios de los roles que tenemos disponibles actualmente (la lista completa se encuentra en el objeto roles de la respuesta de la API).	cuerda / cadena	No	?roles=developer
products	Una lista separada por comas de uno o varios de los roles que tenemos disponibles actualmente (la lista completa se encuentra en el objeto products de la respuesta de la API). La API no admite la jerarquía de productos, por lo que agregue todos los productos a la lista que quiera incluir en la consulta.	cuerda / cadena	No	?products=azure
temas	Una lista separada por comas de uno o varios de los roles que tenemos actualmente disponibles (la lista completa se encuentra en el objeto de asunto de la respuesta de la API). La API no admite la jerarquía de firmantes, por lo que agregue todos los sujetos a la lista que quiera incluir en la consulta.	cuerda / cadena	No	?subjects=cloud-computing
maxpagesize	Número máximo de recursos que se pueden incluir en una sola respuesta. El valor predeterminado es 30. El valor máximo permitido es 100.	cuerda / cadena	No	?maxpagesize=50

Respuesta de API

El servicio puede devolver los siguientes códigos de estado HTTP.

Código de estado	Description
200	Éxito. El cuerpo de la respuesta incluye los datos codificados en JSON.
400	Uno de los parámetros de consulta falta o no es válido.
401	Consulta no autorizada.
404	No se encontró la dirección URL en el servidor.
429	La solicitud tenía una tasa limitada.
500	Evento de servidor inesperado.
503	El servicio no está disponible temporalmente.

Una respuesta correcta incluirá detalles para cada punto de conexión, como se muestra a continuación.

Cuerpo de respuesta

Respuesta del módulo

Registros de módulo

Cada registro de módulo tendrá el siguiente formato:

{
  "type": "module",
  "id": "learn.wwl.fundamentals-generative-ai",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/",
  "locale": "en-us",
  "title": "Introduction to generative AI and agents",
  "durationInMinutes": 37,
  "summary": "Ever wondered how AI can create content, answer questions, and assist with tasks? This module introduces you to the world of generative AI and agents.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/fundamentals-generative-ai.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "units": [
    {
      "id": "learn.wwl.fundamentals-generative-ai.introduction"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.language-models"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.writing-prompts"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.agents"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.exercise-ai-agent"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.knowledge-check"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.summary"
    }
  ],
  "updatedAt": "2025-12-23T00:20:00.0000000Z"
}

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: module.
id	string	Sí	Identificador de módulo único global.
url	uri	Sí	Dirección URL completa del módulo en la configuración regional solicitada.
locale	string	Sí	Localización del contenido del módulo. El valor predeterminado es en-us si la configuración regional solicitada no está disponible.
title	string	Sí	Título del módulo localizado.
durationInMinutes	integer	Sí	Promedio de tiempo de finalización del módulo en minutos.
summary	string	Sí	Descripción breve del módulo.
iconUrl	uri	Sí	URL de un icono de módulo transparente de 100×100 en SVG.
levels	Level[]	Sí	Niveles de experiencia asociados a este módulo.
roles	Role[]	Sí	Roles de trabajo pertinentes.
products	Product[]	Sí	Clasificaciones de productos pertinentes.
subjects	Subject[]	Sí	Clasificaciones pertinentes del sujeto.
units	UnitReference[]	Sí	Unidades de aprendizaje asociadas.
updatedAt	date-time	Sí	Marca de tiempo actualizada por última vez (es posible que no cambie en ediciones secundarias).

Registros de unidad

Cada registro de unidad tendrá el siguiente formato:

{ 
"type": "unit",
  "id": "learn.wwl.fundamentals-generative-ai.agents",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/7-agents/",
  "locale": "en-us",
  "title": "AI agents",
  "durationInMinutes": 5,
  "updatedAt": "2025-10-06T17:09:00.0000000Z"
},

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: unit.
id	string	Sí	Identificador único de esta unidad en Microsoft Learn.
url	uri	Sí	Dirección URL completa de la unidad en la configuración regional solicitada.
locale	string	Sí	Configuración regional de la unidad; vuelve a en-us si la configuración regional solicitada no está disponible.
title	string	Sí	Título de la unidad localizada (alternativa: inglés de EE. UU.).
durationInMinutes	integer	Sí	Tiempo medio de finalización en minutos.
updatedAt	date-time	Sí	La última marca de tiempo actualizada puede permanecer sin cambios para pequeñas modificaciones.

Registros de ruta de aprendizaje

Cada registro de ruta de aprendizaje tendrá el siguiente formato:

{
  "type": "learningPath",
  "id": "learn.introduction-ai-azure",
  "url": "https://learn.microsoft.com/training/paths/introduction-to-ai-on-azure/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "durationInMinutes": 669,
  "summary": "This course introduces core concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions, focusing on Microsoft Foundry.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/document-intelligence-knowledge-mining.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "modules": [
    {
      "id": "learn.wwl.get-started-ai-fundamentals"
    },
    {
      "id": "learn.wwl.get-started-ai-in-foundry"
    },
    {
      "id": "learn.wwl.fundamentals-machine-learning"
    },
    {
      "id": "learn.wwl.design-machine-learning-model-training-solution"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai"
    },
    {
      "id": "learn.wwl.get-started-generative-ai-azure"
    },
    {
      "id": "learn.wwl.introduction-language"
    },
    {
      "id": "learn.wwl.get-started-language-azure"
    },
    {
      "id": "learn.wwl.introduction-ai-speech"
    },
    {
      "id": "learn.wwl.recognize-synthesize-speech"
    },
    {
      "id": "learn.wwl.introduction-computer-vision"
    },
    {
      "id": "learn.wwl.get-started-computer-vision"
    },
    {
      "id": "learn.wwl.introduction-information-extraction"
    },
    {
      "id": "learn.wwl.ai-information-extraction"
    }
  ],
  "updatedAt": "2025-12-12T00:08:00.0000000Z"
}

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: learningPath.
id	string	Sí	Identificador único de esta ruta de aprendizaje en Microsoft Learn.
url	uri	Sí	Dirección URL completa de la ruta de aprendizaje en la configuración regional solicitada.
locale	string	Sí	Localización en la que se ha escrito la ruta de aprendizaje; vuelve a en-us si la localización solicitada no está disponible.
title	string	Sí	Título de la ruta de aprendizaje localizada.
durationInMinutes	integer	Sí	Tiempo medio de finalización de la ruta de aprendizaje en minutos.
summary	string	Sí	Descripción breve de la ruta de aprendizaje.
iconUrl	uri	Sí	Dirección URL a un icono SVG de 100×100 que representa la ruta de aprendizaje.
levels	Level[]	Sí	Niveles de experiencia asociados a la ruta de aprendizaje.
roles	Role[]	Sí	Roles de trabajo pertinentes.
products	Product[]	Sí	Clasificaciones de productos pertinentes.
subjects	Subject[]	Sí	Clasificaciones pertinentes del sujeto.
modules	ModuleReference[]	Sí	Referencias de módulo asociadas.
updatedAt	date-time	Sí	La última marca de tiempo actualizada puede permanecer sin cambios para pequeñas modificaciones.

Registros de aptitudes aplicadas

Cada registro de aptitudes aplicadas tendrá el siguiente formato:

{
  "type": "appliedSkills",
  "id": "applied-skill.deploy-and-configure-azure-monitor",
  "locale": "en-us",
  "title": "Microsoft Applied Skills: 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",
  "iconUrl": "https://learn.microsoft.com/",
  "url": "https://learn.microsoft.com/credentials/applied-skills/deploy-and-configure-azure-monitor/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "administrator",
      "name": "Administrator"
    }
  ],
  "products": [
    {
      "id": "azure-monitor",
      "name": "Azure Monitor"
    },
    {
      "id": "azure-virtual-machines",
      "name": "Azure Virtual Machines"
    },
    {
      "id": "azure-virtual-network",
      "name": "Azure Virtual Network"
    },
    {
      "id": "windows-server",
      "name": "Windows Server"
    }
  ],
  "subjects": [
    {
      "id": "it-management-monitoring",
      "name": "IT management and monitoring"
    }
  ],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: appliedSkills.
id	string	Sí	Identificador único de esta aptitud aplicada en Microsoft Learn.
locale	string	Sí	Configuración regional en la que está escrita la aptitud aplicada; recurre a en-us si la configuración regional solicitada no está disponible.
title	string	Sí	Título de la aptitud aplicada localizada.
summary	string	Sí	Descripción breve de la aptitud aplicada.
iconUrl	uri	Sí	Dirección URL a un icono SVG de 100×100 que representa la aptitud aplicada.
url	uri	Sí	Dirección URL completa de la aptitud aplicada en la configuración regional solicitada.
levels	Level[]	Sí	Niveles de experiencia asociados a esta aptitud aplicada.
roles	Role[]	Sí	Roles de trabajo pertinentes.
products	Product[]	Sí	Clasificaciones de productos pertinentes.
subjects	Subject[]	Sí	Clasificaciones pertinentes del sujeto.
updatedAt	date-time	Sí	Última marca de tiempo actualizada; puede permanecer sin cambios para las actualizaciones secundarias.

Registros de certificación

Cada registro de certificación tendrá el siguiente formato:

{
  "type": "certification",
  "id": "certification.d365-functional-consultant-customer-service",
  "locale": "en-us",
  "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate (Legacy with Power Platform)",
  "subtitle": "<p>If you’re a functional consultant responsible for configuring and implementing Dynamics 365 solutions for customers, you can use this certification to shine a light on your skills and to help advance your career. A Dynamics 365 Customer Service functional consultant implements omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction. As a functional consultant, you know how to work with project managers, developers, and solution architects. You need a minimum of one to three years of experience as a functional consultant implementing Dynamics 365.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Work as a Dynamics 365 functional consultant on one or more projects.</li>\n<li>Work on a Dynamics 365 Customer Service implementation.</li>\n<li>Join the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>.</li>\n<li>Take available learning paths on <a href=\"/training/browse/?expanded=dynamics-365&amp;products=dynamics-customer-service&amp;roles=functional-consultant&amp;resource_type=learning%20path\">Microsoft Learn</a>.</li>\n<li>Complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course.</li>\n</ul>\n<div class=\"WARNING\">\n<p>Warning</p>\n<p>This version of the certification is no longer available. <a href=\"https://techcommunity.microsoft.com/t5/microsoft-learn-blog/new-exam-structure-for-dynamics-365-certifications-for-customer/ba-p/3500861\">Read this blog post for more information about this change</a>.</p>\n</div>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/d365-functional-consultant-customer-service-legacy-with-power-platform/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-analyst",
      "name": "Business Analyst"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "functional-consultant",
      "name": "Functional Consultant"
    }
  ],
  "products": [
    {
      "id": "power-apps",
      "name": "Power Apps"
    },
    {
      "id": "power-bi",
      "name": "Power BI"
    },
    {
      "id": "power-automate",
      "name": "Power Automate"
    },
    {
      "id": "dataverse",
      "name": "Microsoft Dataverse"
    },
    {
      "id": "ai-builder",
      "name": "AI Builder"
    },
    {
      "id": "power-platform",
      "name": "Microsoft Power Platform"
    },
    {
      "id": "office-teams",
      "name": "Microsoft Teams"
    },
    {
      "id": "microsoft-copilot-studio",
      "name": "Microsoft Copilot Studio"
    },
    {
      "id": "dynamics-365",
      "name": "Dynamics 365"
    },
    {
      "id": "dynamics-customer-service",
      "name": "Customer Service"
    }
  ],
  "subjects": [],
  "certificationType": {
    "id": "role-based",
    "name": "role-based"
  },
  "renewalFrequencyInDays": 0,
  "prerequisites": [],
  "exams": [
    {
      "id": "exam.mb-230"
    }
  ],
  "updatedAt": "2024-10-08T15:40:00.0000000Z"
}

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: certification.
id	string	Sí	Identificador único de esta certificación en Microsoft Learn.
locale	string	Sí	Configuración regional en la que se escribe la certificación; vuelve a en-us si la configuración regional solicitada no está disponible.
title	string	Sí	Título de certificación localizado.
subtitle	string	Sí	Subtítulo de certificación localizado.
iconUrl	uri	Sí	Dirección URL a un icono SVG de 100×100 que representa la certificación.
url	uri	Sí	Dirección URL completa de la certificación en la configuración regional solicitada.
levels	Level[]	Sí	Niveles de experiencia asociados a esta certificación.
roles	Role[]	Sí	Roles de trabajo pertinentes.
products	Product[]	Sí	Clasificaciones de productos pertinentes.
subjects	Subject[]	Sí	Clasificaciones pertinentes del sujeto.
certificationType	Taxonomy	Sí	Clasificación que representa el tipo de certificación.
renewalFrequencyInDays	integer	Sí	Número de días antes de que expire esta certificación; 0 significa que no expira.
prerequisites	string[]	Sí	Lista de requisitos previos recomendados para obtener esta certificación.
exams	ExamReference[]	Sí	Exámenes asociados necesarios para esta certificación.
updatedAt	date-time	Sí	Marca de tiempo de la última actualización; puede permanecer sin cambios en ediciones menores.

Registros de examen

Cada registro de examen tendrá el siguiente formato:

{
  "type": "exam",
  "id": "exam.77-881",
  "locale": "en-us",
  "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.",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/exams/77-881/",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-user",
      "name": "Business User"
    }
  ],
  "products": [
    {
      "id": "office-word",
      "name": "Word"
    }
  ],
  "locales": [],
  "examNumber": "77-881",
  "pdfUrl": "https://learn.microsoft.comhttps//query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
  "practiceAssessmentUrl": "https://learn.microsoft.com/",
  "providers": [],
  "courses": [],
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: exam.
id	string	Sí	Identificador único de este examen en Microsoft Learn.
locale	string	Sí	Configuración regional en la que se escribe el examen; vuelve a en-us si la configuración regional solicitada no está disponible.
title	string	Sí	Título del examen localizado.
subtitle	string	Sí	Subtítulo del examen localizado.
iconUrl	uri	Sí	Dirección URL a un icono SVG de 100×100 que representa el examen.
url	uri	Sí	Dirección URL completa del examen en la configuración regional solicitada.
levels	Level[]	Sí	Niveles de experiencia asociados a este examen.
roles	Role[]	Sí	Roles de trabajo pertinentes.
products	Product[]	Sí	Clasificaciones de productos pertinentes.
locales	Locale[]	Sí	Idiomas en los que se ofrece oficialmente el examen.
examNumber	string	Sí	Identificador de número de examen.
pdfUrl	uri	No	URL del PDF "Competencias medidas" para este examen.
practiceAssessmentUrl	uri	No	Dirección URL de una evaluación de práctica gratuita para este examen.
providers	Provider[]	No	Proveedores que ofrecen este examen.
courses	Course[]	No	Cursos dirigidos por instructores asociados a este examen.
studyGuide	StudyGuideRef[]	No	Contenido de la guía de estudio asociado (referencias polimórficas).
updatedAt	date-time	Sí	La última marca de tiempo actualizada puede permanecer sin cambios para pequeñas modificaciones.

Registros de cursos dirigidos por instructores

Cada registro de curso tendrá el siguiente formato:

{
  "type": "course",
  "id": "course.ai-900t00",
  "url": "https://learn.microsoft.com/training/courses/ai-900t00/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "summary": "<p>This course introduces fundamentals concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions. The course is not designed to teach students to become professional data scientists or software developers, but rather to build awareness of common AI workloads and the ability to identify Azure services to support them. The course is designed as a blended learning experience that combines instructor-led training with online materials on the Microsoft Learn platform (<a href=\"https://azure.com/learn\">https://azure.com/learn</a>). The hands-on exercises in the course are based on Learn modules, and students are encouraged to use the content on Learn as reference materials to reinforce what they learn in the class and to explore topics in more depth.</p>\n<h4 id=\"audience-profile\">Audience Profile</h4>\n<p>The Introduction to AI in Azure course is designed for anyone interested in learning about the types of solution artificial intelligence (AI) makes possible, and the services on Microsoft Azure that you can use to create them. You don’t need to have any experience of using Microsoft Azure before taking this course, but a basic level of familiarity with computer technology and the Internet is assumed. Some of the concepts covered in the course require a basic understanding of mathematics, such as the ability to interpret charts. The course includes hands-on activities that involve working with data and running code, so a knowledge of fundamental programming principles will be helpful.</p>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/course.svg",
  "courseNumber": "AI-900T00",
  "durationInHours": 24,
  "locales": [
    {
      "id": "en",
      "name": "en"
    },
    {
      "id": "ar",
      "name": "ar"
    },
    {
      "id": "zh-cn",
      "name": "zh-cn"
    },
    {
      "id": "zh-tw",
      "name": "zh-tw"
    },
    {
      "id": "fr",
      "name": "fr"
    },
    {
      "id": "de",
      "name": "de"
    },
    {
      "id": "id",
      "name": "id"
    },
    {
      "id": "it",
      "name": "it"
    },
    {
      "id": "ja",
      "name": "ja"
    },
    {
      "id": "ko",
      "name": "ko"
    },
    {
      "id": "pt-br",
      "name": "pt-br"
    },
    {
      "id": "ru",
      "name": "ru"
    },
    {
      "id": "es",
      "name": "es"
    }
  ],
  "levels": [],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    }
  ],
  "products": [
    {
      "id": "azure",
      "name": "Azure"
    }
  ],
  "certification": {
    "id": "certification.azure-ai-fundamentals"
  },
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
},

Detalles de la propiedad

Propiedad	Tipo	Obligatorio	Description
type	enum	Sí	Discriminador de tipos. Permitido: course.
id	string	Sí	Identificador único de este curso en Microsoft Learn.
url	uri	Sí	Dirección URL completa del curso en la configuración regional solicitada.
locale	string	Sí	Configuración regional en la que se escribe el curso; vuelve a en-us si la configuración regional solicitada no está disponible.
title	string	Sí	Título del curso localizado.
summary	string	Sí	Breve descripción del curso.
iconUrl	uri	Sí	Dirección URL a un icono SVG de 100×100 que representa el curso.
courseNumber	string	Sí	Número de curso dirigido por instructores.
durationInHours	integer	Sí	Promedio de tiempo para completar el curso (en horas).
locales	Locale[]	Sí	Idiomas en los que se ofrece oficialmente el curso; otros idiomas pueden ser soportados por asociados.
levels	Level[]	Sí	Niveles de experiencia asociados a este curso.
roles	Role[]	Sí	Roles de trabajo pertinentes.
products	Product[]	Sí	Clasificaciones de productos pertinentes.
exam	ExamRef	No	Examen asociado para este curso.
certification	CertRef	No	Certificación asociada para este curso.
studyGuide	StudyGuideRef[]	No	Materiales de estudio relacionados (referencias polimórficas).
updatedAt	date-time	Sí	Última marca de tiempo actualizada; puede permanecer sin cambios para las actualizaciones secundarias.

Registros de nivel, producto, rol y asunto

Las levels, products, roles y subjects colecciones proporcionan nombres descriptivos para los valores usados en los datos de módulo y ruta 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" },
           ...
    ]
}

id coincidirá con los valores de los niveles, productos, roles y temas incluidos en las otras entradas del catálogo. El asociado name proporciona un nombre adecuado en inglés para la entrada. La matriz children es opcional y permite una jerarquía para los valores que tienen relaciones secundarias, como en el caso de productos.

Por ejemplo, este 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"
        },
        ...
    ]
}

Pasos siguientes

Revise los recursos siguientes para ayudarle en el recorrido de desarrollo:

• Inicio rápido: Configuración y uso de los datos del catálogo de API de plataforma de Microsoft Learn
• Preguntas más frecuentes sobre la API de la plataforma de aprendizaje
• Notas de la versión de la API de Learn Platform