Manual de desarrolladores de aplicaciones

Información general overview

Adobe Learning Manager es una solución de gestión del aprendizaje automatizada basada en la nube y centrada en el alumno. Los clientes pueden acceder a los recursos de Learning Manager mediante programación a través de la API de Learning Manager a fin de integrarla con otras aplicaciones empresariales. Asimismo, los socios de Adobe pueden utilizar la API para mejorar la propuesta de valor de Learning Manager ampliando sus funciones o mediante su integración en otros servicios o aplicaciones.

Escenario de uso usagescenario

Mediante la API de Learning Manager, los desarrolladores pueden crear aplicaciones independientes que amplían las funciones de Learning Manager o que integran esta solución en flujos de trabajo de aplicaciones empresariales. Puede desarrollar una aplicación web, un cliente de escritorio o una aplicación para dispositivos móviles con la tecnología que desee. Como desarrollador, puede acceder a los datos de la aplicación desde Learning Manager. La implementación de la aplicación que desarrolle es externa a la plataforma Learning Manager y tendrá control total sobre el ciclo de vida del desarrollo de software a medida que evolucione la aplicación. Por lo general, las aplicaciones las desarrolla una organización del cliente para su uso con la cuenta de Learning Manager. Estas aplicaciones son privadas en esa organización de cliente específica. Además, los socios de Adobe pueden crear aplicaciones genéricas con la API de Learning Manager, que pueden utilizar un gran conjunto de clientes de Learning Manager.

API de Learning Manager apidescription

La API de Learning Manager se basa en los principios de REST y presenta elementos clave del modelo de objetos de Learning Manager a los desarrolladores de aplicaciones mediante HTTP. Antes de conocer los detalles de los puntos finales de la API y los métodos HTTP, los desarrolladores pueden familiarizarse con los diferentes objetos de Learning Manager, sus atributos y sus interrelaciones. Una vez que se conozcan los modelos, resultará útil tener nociones básicas sobre la estructura de las solicitudes y respuestas de la API y de algunos lenguajes de programación conocidos que se admiten de modo genérico en ella.

Para obtener más información sobre los distintos métodos y puntos finales de la API, consulte la Documentación de API de Learning Manager.

API de alumno

Adobe Learning Manager: las API de alumno permiten crear una experiencia de aprendizaje personalizada para los usuarios. El uso de estas API requiere un token de usuario válido y solo se deben usar para los flujos de trabajo en los que haya un alumno con licencia o registrado completa.

Los casos prácticos no registrados requieren un tratamiento especial.

Póngase en contacto con el equipo de Arquitectura de soluciones, en caso de que tenga alguna pregunta sobre el uso adecuado de estas API, y asegúrese de que un arquitecto de soluciones haya revisado una solución antes de implementarla.

Autenticación de API apiauthentication

Al escribir una aplicación que realiza llamadas de API a Learning Manager, debe registrarla mediante la aplicación del administrador de integración.

Las API de Learning Manager utilizan el marco de OAuth 2.0 para autenticar y autorizar las aplicaciones cliente.

Procedimiento

1. Configurar la aplicación

Puede configurar la aplicación con el ID y el secreto de cliente para utilizar los puntos finales adecuados. Una vez registrada la aplicación, puede obtener el ID y el secreto de cliente. Se debe utilizar "Get URL" en el navegador, ya que autentica a los usuarios de Learning Manager mediante sus cuentas preconfiguradas, como SSO, Adobe ID, etc.

GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<one or more comma separated scopes>&response_type=CODE.

Una vez completada correctamente la autenticación, el navegador redirige al URI de redirección indicado en la URL anterior. Se añade el parámetro code junto al URI de redirección.

2. Obtener token de actualización del código

POST https://learningmanager.adobe.com/oauth/token Content-Type: application/x-www-form-urlencoded

Cuerpo de la solicitud POST:

client_id:
<enter your clientid>
 &
 client_secret:
 <enter your clientsecret>
  &
  code:
  <code from step 1></code>
 </enter>
</enter>

3. Obtener un token de acceso a partir del token de actualización

URL para obtener el token de acceso:

POST https://learningmanager.adobe.com/oauth/token/refresh Content-Type: application/x-www-form-urlencoded

Cuerpo de la solicitud POST:

client_id:
<enter your clientid>
 &
 client_secret:
 <enter your clientsecret>
  &
  refresh_token:
  <refresh token>

  </refresh>
 </enter>
</enter>

URL para verificar los detalles del token de acceso

GET https://learningmanager.adobe.com/oauth/token/check?access_token=<access_token>

Limitación de uso

Un token de acceso es válido durante siete días. Después de un día, debe generar un nuevo token de acceso mediante el token de actualización. Si genera un nuevo token de acceso a partir del token de actualización mientras un token de acceso existente sigue siendo válido, se devuelve el token existente.

A continuación, se describen algunos de los términos más utilizados en la API de Learning Manager como referencia.

Includes

Los desarrolladores pueden acceder a un único modelo de objetos de API y también a varios modelos asociados a ese modelo. Para acceder a los modelos relacionados posteriores, debe conocer la relación de cada modelo con otros modelos. Incluye permite a los desarrolladores acceder a los modelos dependientes. Puede utilizar un separador de comas para acceder a varios modelos. Para ver ejemplos de uso y obtener más información sobre incluye, consulte la sección de modelo de API de ejemplo de esta página.

Solicitud de API

Las solicitudes de API se pueden realizar mediante una solicitud HTTP. En función del punto final y el método, el desarrollador puede elegir entre diversos verbos de HTTP, como GET, PUT, POST, DELETE, PATCH, etc. En algunas solicitudes, se pueden transferir parámetros de consulta. Al realizar una solicitud de un modelo de datos específico, el usuario también puede solicitar modelos relacionados, tal y como se describe en las especificaciones de la API JSON. La estructura de una solicitud API típica se describe en el uso del modelo de ejemplo.

Respuesta de API

Si un cliente realiza una solicitud de API, se obtiene un documento JSON según la especificación de API JSON. La respuesta también contiene el código de estado HTTP, que el desarrollador puede comprobar para realizar los pasos siguientes adecuados en la lógica de la aplicación. La estructura de una respuesta de API típica se describe en uso del modelo de muestra.

Errores

Cuando falla una solicitud de API, se obtiene una respuesta de error. El código de estado HTTP devuelto en la respuesta indica la naturaleza del error. Los códigos de error se representan con números para cada modelo en la referencia de API. 200, 204, 400 y 404 son algunos de los errores comunes representados en las API que indican problemas de acceso HTTP.

Fields

Los atributos del objeto de API y sus relaciones se denominan de forma conjunta "Fields". Consulte la API JSON para obtener más información. Puede utilizar "Fields" como parámetro al realizar llamadas de API para obtener uno o más atributos específicos del modelo. Si no se utiliza el parámetro "Fields", la llamada de API obtiene todos los atributos disponibles del modelo. Por ejemplo, en la siguiente llamada de API, los campos[habilidad]=name obtiene únicamente el atributo name del modelo de aptitud.

https://learningmanager.adobe.com/primeapi/v2/users/{userId}/userSkills/{id}?include=skillLevel.skill&fields[skill]=name

Paginación

A veces, una solicitud de API proporciona una larga lista de objetos en la respuesta. En esos casos, el atributo de paginación permite al desarrollador obtener los resultados secuencialmente en varias páginas, en las que cada página contiene un intervalo de registros. Por ejemplo, el atributo de paginación en Learning Manager permite establecer el número máximo de registros que se mostrarán en una página. Además, puede definir el valor del intervalo de registros que se mostrarán en la página.

Ordenación

Se permite la ordenación en los modelos de API. En función del modelo, elija el tipo de ordenación que se aplicará a los resultados. La ordenación se puede aplicar en orden ascendente o descendente. Por ejemplo, si especifica code sort=name, luego es una ordenación ascendente por nombre. Si especifica code sort=-name, es una ordenación descendente por nombre. Consulte la Especificación de API JSON para obtener más información.

Ilustración de uso de API samplemodel

Supongamos que un desarrollador desea obtener el nombre de la aptitud, la cantidad máxima de puntos asignada al nivel de aptitud y los puntos obtenidos por el alumno para esa aptitud.

Un modelo "userSkill" de las API de Learning Manager consta de los atributos predeterminados: id, type, dateAchived, dateCreated y pointsEarned. Por lo tanto, cuando un desarrollador utiliza el método GET para adquirir información del modelo "userSkill", los datos actuales relativos a los atributos predeterminados se muestran en la salida de respuesta.

Sin embargo, en este caso, el desarrollador desea obtener el nombre de la aptitud y los puntos de nivel de aptitud del usuario. La API de Learning Manager permite acceder a esta información relacionada mediante campos de relación y parámetros "include". Los modelos asociados de "userSkill" se obtienen en la etiqueta de relaciones. Puede obtener información de cada uno de los modelos asociados llamándolos junto con el modelo "userSkill". Para obtener esta información, utilice code include parámetro con valores separados por puntos para cada uno de los modelos asociados. Puede utilizar la coma como separador para solicitar otro modelo, como user include=skillLevel.skill,course

Llamada de API

https://learningmanagerqe1.adobe.com/primeapi/v1/users/%7buserId%7d/userSkills/%7bid%7d?include=skillLevel.skill&fields%5bskill%5d=name&fields%5bskillLevel%5d=maxCredits&fields%5buserSkill%5d=pointsEarned

Por ejemplo, "userId" puede ser 746783 y "userSkills id" puede ser 746783_4426_1.

Respuesta de llamada de API

\{
 "links": {"self": "https://learningmanager.adobe.com/primeapi/v2/users/746783/userSkills/746783_4426_1?include=skillLevel.skill&fields[userSkill]=pointsEarned&fields[skillLevel]=maxCredits&fields[skill]=name"},
 "data": {
 "id": "746783_4426_1",
 "type": "userSkill",
 "attributes": {"pointsEarned": 5},
 "links": {"self": "https://learningmanager.adobe.com/primeapi/v2/users/746783/userSkills/746783_4426_1"}
 },
 "included": [
 {
 "id": "4426",
 "type": "skill",
 "attributes": {"name": "Java"},
 "links": {"self": "https://learningmanager.adobe.com/primeapi/v2/skills/4426"}
 },
 {
 "id": "4426_1",
 "type": "skillLevel",
 "attributes": {"maxCredits": 10}
 }
 ]
}

Modelos de Learning Manager models

La API de Learning Manager permite que los desarrolladores accedan a los objetos de Learning Manager como recursos RESTful. Cada punto final de la API representa un recurso, por lo general, una instancia de objeto como una insignia o una colección de esos objetos. Así, los desarrolladores utilizan verbos de HTTP como PUT, GET, POST y DELETE para efectuar operaciones CRUD en esos objetos (colecciones).

Lista de atributos de objeto y relaciones.

Proceso de desarrollo de aplicaciones registration

Requisitos previos prerequisites

Como desarrollador, debe crear una cuenta de prueba en Learning Manager para poder tener acceso completo a todas las funciones de esa cuenta. Asimismo, para poder escribir una aplicación, el desarrollador debe crear varios usuarios y cursos, y lograr que la cuenta tenga un estado razonable para que la aplicación que se desarrolla tenga acceso a datos de ejemplo.

Crear el ID y el secreto de cliente createclientidandsecret

Desarrollo y prueba de aplicaciones applicationdevelopmentandtesting

Los desarrolladores pueden utilizar la API de Learning Manager para crear cualquier aplicación. Estos deben asegurarse de que sus cuentas incluyan algunos usuarios y cursos válidos. Pueden crear algunos usuarios y cursos ficticios y simular actividad en la cuenta de prueba para que puedan probar la funcionalidad de la aplicación.

Implementación de aplicaciones applicationdeployment

Es recomendable que el administrador de Learning Manager o un administrador de integración de la cuenta de producción asuman la responsabilidad de facilitar la aplicación a los usuarios de su organización. Una vez que la aplicación se haya probado y se considere lista para la producción, informe al administrador de la cuenta de producción. Lo ideal es que los administradores generen un nuevo ID y secreto de cliente para la aplicación en la cuenta de producción y realicen los pasos necesarios para incorporarlos en la aplicación de forma segura. El procedimiento real de implementación de aplicaciones varía de una empresa a otra y el administrador de Learning Manager de su organización debe obtener asistencia del departamento de TI/SI de su organización para completar la implementación.

Aprobación de aplicaciones externas externalapplicationapproval

Puede agregar aplicaciones externas haciendo clic en Aprobar en la esquina superior derecha del Aplicaciones página. Indique el ID de la aplicación externa y haga clic en Guardar.

Agregar y aprobar una aplicación externa

Preguntas más frecuentes