Introducción a las características de la API del catálogo de Microsoft Learn
La API del catálogo de Microsoft Learn es una API web basada en REST permite enviar una consulta basada en web a Microsoft Learn y obtener detalles sobre el contenido de entrenamiento disponible y los exámenes de certificación, como títulos, productos cubiertos, niveles, vínculos a entrenamiento y otros metadatos y devuelve una respuesta codificada con JSON con la información.
Devuelve información sobre todos los elementos disponibles públicamente:
- Módulos
- Unidades
- Rutas de aprendizaje
- Aptitudes aplicadas
- Certificaciones
- Exámenes
- Cursos de Instructor-Led
Nota
Como parte de la actualización reciente del sitio de Microsoft Learn, hay un nuevo punto de conexión de API de catálogo disponible en el dominio de learn.microsoft.com. El punto de conexión anterior seguirá funcionando según lo previsto, pero las ventajas de cambiar al nuevo punto de conexión son que le proporcionará características mejoradas, como parámetros de consulta adicionales.
Casos de uso
- Visualización de metadatos sobre ofertas de aprendizaje o certificación de Microsoft Learn
- Extraer una lista de las ofertas de aprendizaje o certificación de Microsoft Learn para vincularlas desde su propia experiencia en línea
Funcionamiento de learn Catalog API
La API es una API web basada en REST que devuelve una respuesta codificada por JSON. Para solicitar el catálogo completo, envíe una solicitud GET a:
https://learn.microsoft.com/api/catalog/
La salida será similar a la captura de pantalla siguiente. A partir de noviembre de 2022, la respuesta completa es de aproximadamente 13 MB.
Cada elemento de catálogo de aprendizaje es un objeto, con un conjunto de metadatos disponibles para cada uno. El diccionario de datos completo y otras opciones se enumeran en la documentación para desarrolladores de la API del catálogo de Microsoft Learn . También tenemos notas de la versión (vínculo) para ver cuáles son las actualizaciones más recientes y procedimientos recomendados información.
Si está interesado en usarlo, consulte el artículo Introducción a la API del catálogo de Microsoft Learn con cURL y Visual Studio Code.
Requisitos
No se requiere autenticación para acceder a la API del catálogo de Microsoft Learn. Los usuarios pueden usar su método de solicitud de API preferido, como cURL, Postman, etc.
Ejemplos
A continuación se muestran algunas de las muchas maneras en que vemos a los usuarios que usan learn Catalog API:
- Viva Learning ha usado la API de catálogo de Learn para ofrecer el catálogo de Microsoft Learn como parte de su experiencia principal.
- Las organizaciones e instituciones educativas usan learn Catalog API para extraer información del catálogo y publicarla en sus sistemas internos de administración de aprendizaje (LMS), por lo que sus empleados y estudiantes pueden acceder fácilmente a ella.
- Los proveedores de aprendizaje usan learn Catalog API para extraer información del catálogo y publicarla en sus experiencias de aprendizaje de los clientes.
Disponibilidad y precios
La API del catálogo de Microsoft Learn está disponible públicamente y se ofrece bajo el término de los términos de uso de las API de Microsoft . No hay ningún cargo por usar la API.
Limitaciones
- La API contiene módulos, unidades, rutas de aprendizaje, cursos dirigidos por instructores, exámenes y certificaciones disponibles públicamente. No genera documentación, ejemplos de código, muestras o eventos en este momento.
- La API actualiza al menos una vez al día.
- Las actualizaciones de la versión de la API se comunicarán a través de las notas de versión de la API del catálogo de Learn .
Pasos siguientes
Para más información sobre Learn Catalog API, revise los artículos siguientes: