Manuel du développeur d’applications

Vue d’ensemble overview

Adobe Learning Manager est une solution de gestion d’apprentissage en libre-service dédiée aux élèves et hébergée sur le cloud. Les clients peuvent accéder aux ressources de Learning Manager par programmation à l’aide de l’API Captivate Prime pour les intégrer à d’autres applications d’entreprise. L’API peut également être utilisée par les partenaires Adobe pour renforcer la proposition de valeur de Learning Manager en étendant ses fonctionnalités ou en les intégrant à d’autres applications ou services.

Scénario d’utilisation usagescenario

En utilisant l’API Learning Manager, les développeurs peuvent créer des applications autonomes qui étendent la fonctionnalité Learning Manager ou intègrent Learning Manager à d’autres flux de travail d’applications d’entreprise. Vous pouvez développer une application Web, un client de bureau ou une application mobile en utilisant la technologie de votre choix. En tant que développeur, vous pouvez accéder aux données de votre application depuis Learning Manager. Le déploiement de l’application que vous développez est externe à la plate-forme Learning Manager et vous avez un contrôle total sur le cycle de vie du développement logiciel à mesure que l’application évolue. Les applications sont généralement développées par une organisation de client pour être utilisées avec leur compte Learning Manager, et ces applications sont « privées » pour cette organisation spécifique de client. En outre, les partenaires Adobe peuvent créer des applications génériques avec l’API Learning Manager, qui peut être utilisée par un grand nombre de clients Learning Manager.

API Learning Manager apidescription

L’API Learning Manager est basée sur des principes REST et expose les éléments clés du modèle d’objet Learning Manager aux développeurs d’applications via HTTP. Avant de connaître les détails des points de terminaison API et des méthodes HTTP, les développeurs peuvent se familiariser avec les différents objets Learning Manager, leurs attributs et leurs relations. Une fois les modèles bien compris, il est utile de bien cerner la structure des demandes et des réponses d’API et de bien comprendre quelques termes courants de programmation que nous utilisons de manière générique dans l’ensemble de l’API.

Pour plus de détails sur les différents points de terminaison et méthodes d'API, consultez la documentation de l'API Learning Manager.

API des élèves

Adobe Learning Manager : les API des élèves vous permettent de créer une expérience d’apprentissage personnalisée pour vos utilisateurs. L’utilisation de ces API nécessite un jeton utilisateur valide et doit être utilisée uniquement dans le cadre des workflows où il y a un élève entièrement licencié/inscrit.

Les cas d’utilisation non enregistrés nécessitent une manipulation spéciale.

Si vous avez des questions sur l'utilisation appropriée de ces API, contactez l'équipe d'architecture de solution et assurez-vous qu'un architecte de solution a validé une solution avant de la déployer.

Authentification API apiauthentication

Lorsque vous écrivez une application qui effectue des appels d’API à Learning Manager, vous devez enregistrer votre application à l’aide de l’application d’administration d’intégration.

Les API Learning Manager utilisent l’infrastructure OAuth 2.0 pour authentifier et autoriser vos applications client.

Procédure

1. Configurer votre application

Vous pouvez configurer votre application avec l’ID client et le secret client pour utiliser les points de terminaison appropriés. Une fois l’application enregistrée, vous pouvez obtenir les paramètres clientId et clientSecret. Get URL doit être utilisé dans le navigateur, car il authentifie les utilisateurs de Learning Manager à l’aide de leurs comptes préconfigurés tels que 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.

Une fois l’authentification réussie, votre navigateur se redirige vers l’URI de redirection de l’URL ci-dessus. Un code de paramètre est ajouté avec l’URI de redirection.

2. Obtenir le jeton d’actualisation à partir du code

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

Corps de la demande de publication :

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

3. Obtenir un jeton d'accès à partir du jeton d'actualisation

URL d’obtention du jeton d’accès :

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

Corps de la demande de publication :

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

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

URL de vérification des détails du jeton d’accès

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

Limitation d’utilisation

Un jeton d’accès est valide pendant sept jours. Après une journée, vous devez générer un nouveau jeton d’accès à l’aide du jeton d’actualisation. Si vous générez un nouveau jeton d’accès à partir du jeton d’actualisation alors qu’un jeton d’accès existant est toujours valide, le jeton existant est renvoyé.

Certains termes fréquemment utilisés dans l’API Learning Manager sont expliqués ci-dessous pour référence.

Inclut

Les développeurs peuvent accéder à un seul modèle d’objet API et à plusieurs modèles associés à ce modèle. Pour accéder aux modèles connexes suivants, vous devez comprendre la relation de chaque modèle avec d’autres modèles. Le paramètre Includes permet aux développeurs d'accéder aux modèles dépendants. Vous pouvez utiliser le séparateur de virgule pour accéder à plusieurs modèles. Pour obtenir un exemple d'utilisation et plus de détails sur l'inclusion, consultez la section Exemple de modèle d'API dans cette page.

Demande d’API

Les demandes d’API peuvent être faites à l’aide d’une requête HTTP. Selon le point de terminaison et le développeur de méthodes, vous avez le choix entre divers verbes HTTP, tels que GET, PUT, POST, DELETE, PATCH, etc. Pour certaines requêtes, les paramètres de requête peuvent être transmis. Lors de la création d’une requête pour un modèle de données spécifique, l’utilisateur peut également demander des modèles associés, comme décrit dans les spécifications de l’API JSON. La structure d’une demande d’API typique est décrite dans l’exemple d’utilisation du modèle.

Réponse de l’API

Lorsqu’une demande d’API est faite par un client, un document SON est obtenu conformément à la spécification de l’API JSON. La réponse contient également le code d’état HTTP, que le développeur peut vérifier pour effectuer les étapes suivantes appropriées dans sa logique d’application. La structure d'une réponse API typique est décrite dans exemple d'utilisation de modèle.

Erreurs

Lorsqu’une demande d’API échoue, une réponse Erreur est obtenue. Le code d’état HTTP renvoyé dans la réponse indique la nature de l’erreur. Les codes d’erreur sont représentés avec des numéros pour chaque modèle dans la référence API. 200, 204, 400 et 404 sont quelques-unes des erreurs courantes représentées dans les API indiquant des problèmes d’accès HTTP.

Champs

Les attributs de l’objet API et ses relations sont appelés collectivement Champs. Reportez-vous à l’API JSON pour plus d’informations. Vous pouvez utiliser Fields comme paramètre lors d'appels API pour récupérer un ou plusieurs attributs spécifiques à partir du modèle. En l’absence du paramètre Champs, l’appel API extrait tous les attributs disponibles du modèle. Par exemple, dans l'appel d'API suivant, fields[skill]=name vous récupère l'attribut name du modèle de compétence seul.

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

Pagination

Parfois, une requête API entraîne une longue liste d’objets à retourner dans la réponse. Dans de tels cas, l’attribut de pagination permet au développeur d’extraire les résultats séquentiellement en termes de pages multiples, chaque page contenant une série d’enregistrements. Par exemple, l’attribut de pagination dans Learning Manager vous permet de définir le nombre maximal d’enregistrements à afficher dans une page. En outre, vous pouvez définir la valeur de plage des enregistrements à afficher sur la page.

Tri

Le tri est autorisé dans les modèles d’API. En fonction du modèle, choisissez le type de tri à appliquer pour les résultats. Le tri peut être appliqué par ordre croissant ou décroissant. Par exemple, si vous spécifiez code sort=name, il s'agit d'un tri croissant par nom. Si vous spécifiez code sort=-name, il s'agit d'un tri décroissant par nom. Reportez-vous à la spécification technique de l'API JSON pour plus d'informations.

Illustration d’utilisation de l’API samplemodel

Imaginons un scénario dans lequel un développeur souhaite obtenir le nom de la compétence, le nombre maximal de points attribués pour le niveau de compétence et les points obtenus par l’élève pour cette compétence.

Un modèle userSkill dans les API Learning Manager est constitué des attributs par défaut suivants : id, type, dateAchieved, dateCreated, pointsEarned. Ainsi, lorsqu’un développeur utilise la méthode GET pour acquérir des détails du modèle userSkill, les données actuelles relatives aux attributs par défaut sont affichées dans la sortie de réponse.

Mais, dans ce scénario, le développeur veut obtenir le nom de la compétence et les points de niveau de compétence pour l’utilisateur. L’API Learning Manager vous permet d’accéder à ces informations associées à l’aide de champs de relation et d’inclure des paramètres. Les modèles associés à userSkill sont obtenus dans la balise de relations. Vous pouvez obtenir les détails de chaque modèle associé en appelant ces modèles avec userSkill. Pour obtenir ces informations, utilisez le paramètre code include avec des valeurs séparées par des points (point) pour chacun des modèles associés. Vous pouvez utiliser une virgule comme séparateur pour demander un autre modèle comme l’utilisateur include=skillLevel.skill, course

Appel 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

Par exemple userId peut être 746783 et userSkills id 746783_4426_1.

Réponse de l’appel 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}
 }
 ]
}

Modèles Learning Manager models

L’API Learning Manager permet aux développeurs d’accéder aux objets Learning Manager en tant que ressources RESTful. Chaque point de terminaison de l’API représente une ressource. Il s’agit généralement d’une instance d’objet comme Badge ou un ensemble de ces objets. Les développeurs utilisent ensuite les verbes HTTP tels que PUT, GET, POST et DELETE pour effectuer des opérations CRUD sur ces objets (collections).

Liste des relations et des attributs d’objet.

Processus de développement de l’application registration

Prérequis prerequisites

En tant que développeur, vous devez créer un compte d’évaluation sur Learning Manager afin de bénéficier d’un accès complet à tous les rôles dans ce compte. Pour pouvoir créer une application, le développeur doit également créer certains utilisateurs et cours et obtenir un état satisfaisant pour le compte, de façon à ce que l’application en cours de développement puisse avoir accès à des données factices.

Créer l’ID et le secret client createclientidandsecret

Développement et test d’applications applicationdevelopmentandtesting

L’API Learning Manager peut être utilisée par les développeurs pour créer n’importe quelle application. Les développeurs doivent s’assurer que leurs comptes disposent d’utilisateurs et de cours valides. Ils peuvent créer quelques utilisateurs et cours fictifs et simuler une activité dans le compte d’essai afin qu’ils puissent tester le fonctionnement de l’application.

Déploiement de l’application applicationdeployment

Nous recommandons à l’administrateur Learning Manager ou à un administrateur d’intégration du compte de production de prendre en charge la mise à disposition de l’application aux utilisateurs de leur organisation. Une fois que l’application a été testée et considérée comme prête pour la production, informez l’administrateur du compte de production. Dans l’idéal, les administrateurs veulent générer un nouveau client-id et un nouveau client-secret pour l’application dans le compte de production et effectuer les étapes nécessaires pour les intégrer de manière sécurisée. La procédure de déploiement des applications varie d’une entreprise à l’autre et l’administrateur Learning Manager de votre organisation doit collaborer avec le département informatique de votre organisation pour terminer le déploiement.

Approbation des applications externes externalapplicationapproval

Vous pouvez ajouter des applications externes en cliquant sur Approuver dans le coin supérieur droit de la page Applications. Indiquez l’ID de l’application externe et cliquez sur Enregistrer.

Ajouter et approuver une application externe

Forum aux questions