Preguntas más frecuentes sobre la API de catálogo de Microsoft Learn
En este artículo se enumeran las preguntas más frecuentes sobre la API de catálogo de Microsoft Learn, con sus respuestas y vínculos a más información cuando es necesario.
General
P: ¿Cuánto cuesta usar la API de catálogo de Learn?
El uso de la API de catálogo de Learn no tiene ningún costo. Para obtener más información, consulte la sección Disponibilidad y precios del artículo Introducción a la API de catálogo de Microsoft Learn.
P: ¿Cuáles son las reglas para usar la API de catálogo de Learn?
Consulte los Términos de uso de API de Microsoft y de Microsoft Learn.
P: ¿Es necesario incorporar u obtener claves para usar la API de catálogo de Learn?
No. La API está disponible públicamente. Consulte los artículos Introducción al uso de la API de catálogo de Microsoft Learn con curl y Visual Studio Code y/o Documentación de la API de catálogo de Microsoft Learn para desarrolladores.
P: ¿Permitirá esta API que nuestros usuarios consuman el contenido de Learn dentro de nuestra plataforma?
No. La API de catálogo de Learn proporciona metadatos sobre el contenido y vínculos directos a ese contenido. Los usuarios pueden integrar estos vínculos en cualquier experiencia web o sistema de administración de aprendizaje (LMS) según losTérminos de uso de la API de Microsoft .
P: ¿Los datos que devuelve la API de catálogo de Learn permanecen estáticos o cambian?
Los datos cambian cada vez que se agrega, modifica o elimina contenido, que suele ser a diario.
Respuesta de la API
P: ¿Se pueden obtener todos los datos a la vez?
Sí. Use el punto de conexión base, learn.microsoft.com/api/catalog para obtener la respuesta completa. Para obtener más información sobre solicitudes a la API, consulte la Documentación de la API de catálogo de Microsoft Learn para desarrolladores.
P: ¿Se puede filtrar la respuesta previamente?
Sí. Consulte los filtros de consulta disponibles en el artículo Documentación de la API de catálogo de Microsoft Learn para desarrolladores.
P: ¿Los UID son únicos para cada objeto de contenido?
Sí. UID significa "id. único" y es único para cada objeto de contenido. Si cambia un UID, aunque el título u otros metadatos permanezcan iguales, el contenido se considera un nuevo objeto.
P: ¿Por qué hay etiquetas HTML en el resumen del módulo?
Normalmente, intentamos mantener el formato del resumen lo más simple posible, pero, a veces, es necesario resaltar o vincular algún texto.
P: ¿Por qué no hay vínculos para las unidades por separado?
Las unidades no están escritas como contenido independiente. Están pensadas 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 para que los usuarios puedan empezar ahí y continuar con el contenido.
P: ¿Cómo se puede saber qué contenido es nuevo?
El valor de last_modified indica cuándo se modificó por última vez el registro.
P: ¿Está habilitado el inicio de sesión único (SSO) para los vínculos del contenido?
De momento, no. Nuestro objetivo es habilitar el inicio de sesión único en el futuro.
Contenido
P: ¿El UID es único para el contenido?
Sí. UID significa "id. único" y es único para cada objeto de contenido. Si cambia un UID, aunque el título u otros metadatos permanezcan iguales, el contenido se considera un nuevo objeto.
P: ¿Todos los módulos forman parte de una ruta de aprendizaje?
No. Los módulos se pueden realizar de forma independiente, porque enseñan un escenario o concepto íntegramente, sin necesidad de realizar otros módulos previamente. En algunos casos, eso es todo y no forman parte de ninguna ruta de aprendizaje. En otros casos, se agrupan en una o varias rutas de aprendizaje que guían al usuario en el desarrollo de conceptos más avanzados. Un módulo no tiene por qué formar parte de una ruta de aprendizaje, o bien puede formar parte de una o varias rutas de aprendizaje.
P: ¿Cómo puedo saber cuándo se ha agregado, actualizado o eliminado contenido?
Cuando se agregan nuevos objetos de contenido, aparecen como un nuevo objeto (identificado por UID) en la respuesta. Cuando se modifica el contenido, se puede ver en el valor de last_modified. Cuando se elimina el contenido, el objeto de contenido se quita de la respuesta. Aunque a veces hay un ligero retraso en el contenido que se actualiza en la respuesta de la API, cuando un usuario sigue la dirección URL al contenido, siempre ve la información más actual. Cuando se elimina el contenido, la dirección URL anterior le redirigirá al nuevo contenido o experiencia, o a la siguiente mejor opción.
El contenido se actualiza todo el tiempo. Publicamos actualizaciones disponibles dos veces al día. Pueden ser menores, como pequeños cambios en el texto, o mayores, como revisiones, adiciones o eliminaciones importantes. En general, la cartera de contenido se administra como un proyecto masivo de código abierto muy controlado con miles de colaboradores y, como tal, se están produciendo cambios todo el tiempo. Si usa la API de catálogo de Learn en su sistema de producción, debe tener esto en cuenta y hacer que el sistema pueda controlarlo.
P: He seguido un vínculo marcado al contenido, pero ahora me muestra una parte diferente del contenido que esperaba. ¿Por qué?
Nos esforzamos por asegurarnos de que nadie llegue a un punto muerto (404) con vínculos a nuestro sitio. Cuando el contenido se modifica o reemplaza, implementamos una redirección para el vínculo anterior que le llevará automáticamente al nuevo contenido. En caso de que el contenido esté en desuso y no se reemplace por varias razones, le redirigiremos al siguiente mejor contenido adecuado, que puede ser un ámbito ligeramente modificado o a una página de aterrizaje, etc.
P: ¿Cómo puedo obtener acceso a los catálogos de documentación, vídeos y ejemplos de código?
Actualmente no se puede acceder a estos catálogos mediante programación. Nuestro objetivo es habilitar el acceso mediante programación a estos catálogos en el futuro.
Localización
P: ¿Qué idiomas están disponibles en Microsoft Learn?
Hay más de 65 configuraciones regionales disponibles en Microsoft Learn. Puede ver una lista completa desde el pie de página del sitio (seleccione el idioma que está viendo para ver la lista completa).
P: ¿El contenido está disponible en otros idiomas?
Depende. Queremos que el contenido esté disponible en todos los lenguajes en los que están disponibles los productos que se enseñan en el contenido. Cuando los alumnos visitan el sitio de Microsoft Learn en una configuración regional determinada, si el contenido no está disponible en esa configuración regional, el usuario ve el encabezado y el pie de página en su configuración regional deseada y el contenido principal vuelve al inglés hasta que haya disponible una versión localizada.
P: ¿Un objeto de contenido determinado varía en función del idioma en el que se ve?
Posiblemente. Cuando se publican actualizaciones del contenido en inglés, nuestras canalizaciones de localización funcionan para actualizar las versiones localizadas lo antes posible, normalmente en unos pocos días después del cambio en el original.
Otros
P: ¿Hay alguna API o funcionalidad de elaboración de informes para obtener datos como las visualizaciones, los clics o la finalización de actividades de aprendizaje?
Actualmente no tenemos una API de elaboración de informes. Sí hay una funcionalidad de elaboración de informes para las organizaciones que les permite elaborar informes sobre las actividades de aprendizaje que realizan sus usuarios.
Pasos siguientes
Puede consultar más información sobre la API de catálogo de Learn en los siguientes vínculos: