Preguntas más frecuentes sobre la API del catálogo de Microsoft Learn
En este artículo se enumeran las preguntas más frecuentes sobre la API del catálogo de Microsoft Learn, con sus respuestas y vínculos a más información según sea necesario.
General
P: ¿Cuánto cuesta usar learn Catalog API?
No hay ningún costo para usar la API del catálogo de Learn. Para obtener más información, consulte la sección de disponibilidad y precios del artículo sobre la API del catálogo de Learn de que ofrece una visión general.
P: ¿Cuáles son las reglas para usar learn Catalog API?
Consulte los de microsoft Learn y los términos de uso de la API de Microsoft.
Q: ¿Necesito incorporar o obtener claves para usar learn Catalog API?
No. La API está disponible públicamente. Consulte el artículo Introducción a la API de catálogo de Learn mediante cURL y Visual Studio Code o el artículo referencia para desarrolladores de API del catálogo de Learn de .
Q: ¿esta API permitirá a nuestros usuarios consumir el contenido de Learn dentro de nuestra plataforma?
No. Learn Catalog API proporciona metadatos sobre el contenido y vínculos directos al contenido. Los usuarios pueden integrar estos vínculos en cualquier experiencia web o sistema de administración de aprendizaje (LMS) de acuerdo con los términos de uso de la API de Microsoft.
Q: ¿Los datos devueltos desde la API del catálogo de Learn permanecen estáticos o cambian?
Los datos cambian cada vez que se agrega, modifica o elimina contenido nuevo, que suele ser diario.
Respuesta de API
Q: ¿Puedo agarrar todos los datos a la vez?
Sí. Use el punto de conexión base learn.microsoft.com/api/catalog para obtener la respuesta completa. Consulte el artículo Referencia para desarrolladores de API del catálogo de Learn para obtener más información sobre solicitudes de API.
Q: ¿Puedo filtrar previamente la respuesta?
Sí. Consulte los filtros de consulta disponibles en el artículo de referencia para desarrolladores de la API del Catálogo Learn en .
Q: ¿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, incluso si el título u otros metadatos permanecen iguales, el contenido se considera un nuevo objeto.
Q: ¿Por qué hay etiquetas HTML en el resumen del módulo?
Normalmente intentamos mantener el formato del resumen tan sin procesar como sea posible, pero a veces es necesario resaltar o vincular cierto texto.
P: ¿Por qué no hay vínculos para las unidades individuales?
Las unidades no se escriben como contenido independiente. Están diseñados para ser tomados en un orden específico para el módulo. Por este motivo, incluimos el vínculo a la página de detalles del módulo y la primera unidad para que los usuarios puedan empezar allí y continuar con el contenido.
P: ¿Cómo puedo saber qué contenido es nuevo?
El valor de last_modified indica cuándo se modificó por última vez el registro.
Q: ¿Está habilitado el inicio de sesión único (SSO) de Sign-On para los vínculos de contenido?
No en este momento. Queremos habilitar el inicio de sesión único en el futuro.
Contenido
Q: ¿el UID es único para el contenido?
Sí. UID significa "Id. único" y es único para cada objeto de contenido. Si cambia un UID, incluso si el título u otros metadatos permanecen iguales, el contenido se considera un nuevo objeto.
P: ¿Todos los módulos forman parte de una ruta de aprendizaje?
No. Todos los módulos son capaces de ser independientes, en el sentido de que enseñan un escenario o concepto de principio a fin dentro de ellos y no requieren tomar módulos previos. Para algunos, esto es el final y no forman parte de una ruta de aprendizaje. Para otros usuarios, se agrupan en una o varias rutas de aprendizaje que llevan a un usuario a través de la creación de conceptos más avanzados. Un módulo no tiene que formar parte de una ruta de aprendizaje o puede formar parte de uno o varios.
P: ¿Cómo sé cuándo se ha agregado, actualizado o eliminado el contenido?
Cuando se agregan nuevos objetos de contenido, aparecen como un nuevo objeto (identificado por UID) en la respuesta. Cuando se modifica el contenido, puedes saberlo basándote en su valor de última_modificación. 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.
En particular, el contenido se está actualizando todo el tiempo. Publicamos actualizaciones disponibles dos veces al día. Pueden ser menores, como cambios de texto menores o importantes, como revisiones principales, adiciones o eliminaciones importantes. En general, la cartera de contenido se administra como un proyecto de código abierto masivo y altamente regulado con miles de colaboradores y, como tal, se están produciendo cambios todo el tiempo. Si utiliza la API del Catálogo de Aprendizaje en su sistema de producción, debe tenerlo en cuenta y asegurarse de que el sistema pueda manejarlo.
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 obtengo acceso a los catálogos de documentación, vídeo y ejemplo de código?
En este momento no hay ninguna manera de obtener acceso a estos catálogos mediante programación. Pretendemos 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 aquí a través del pie de página del sitio (seleccione el idioma que está viendo para ver la lista completa).
Q: ¿Está disponible el contenido en otros idiomas?
Depende. Queremos que el contenido esté disponible en todos los idiomas 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.
Q: ¿Es diferente el contenido de un objeto de contenido determinado, en función del idioma en el que lo vea?
Posiblemente. Cuando las actualizaciones se publican en el contenido en inglés, nuestras canalizaciones de localización funcionan para actualizar las versiones localizadas lo antes posible, normalmente en unos días después del cambio original.
Otro
Q: ¿Hay alguna API de informes o funcionalidad para obtener datos, como vistas, clics, finalización?
No tenemos una API de informes en este momento. Tenemos funcionalidad de informes de la organización que permite a las organizaciones informar sobre las finalizaciones de sus usuarios.
Pasos siguientes
Puede obtener más información sobre learn Catalog API si visita los vínculos siguientes: