🔗 L'API Didask : automatisez vos workflows en interfaçant Didask avec vos outils métier

📢 Le service d'API offert par Didask vous offre la possibilité d’ouvrir les données de la plateforme de manière sécurisée et permet ensuite à votre système externe (LMS, site web) d'échanger ses données avec la plateforme.

Qu’est-ce qu’une API ?

Une API, c’est un peu comme un serveur dans un restaurant. Elle permet de dialoguer avec la cuisine sans y entrer et sans connaître les termes propres à une cuisine.

Le serveur vous présente un menu : C’est ce que la cuisine est capable de vous préparer.
Vous passez commande : Vous indiquez ce que vous voulez manger.
Le serveur rapporte votre plat : Vous recevez exactement ce que vous avez commandé.

Le menu représente la liste des actions possibles avec l’API.
Passer commande, c’est ce que l’on appelle “consommer une API”.
Le plat que le serveur vous rapporte est la réponse de l’API.

Pourquoi utilise-t-on une API ?

Pour les mêmes raisons qu’on fait appel à un serveur :

Cela évite que vous entriez dans la cuisine avec vos chaussures sales.
Le serveur vous dit ce que vous pouvez commander. Vous ne vous retrouverez pas devant un frigo ou un four à imaginer ce que vous pourriez manger.

🚀 Et l'API Didask ?

Dans le cadre de Didask, nous avons une API qui permet de faire plusieurs choses dans l’application. Le “menu” est composé des propositions suivantes :

Permettre aux utilisateurs de Didask d'ouvrir l'application directement depuis votre LMS et s'authentifier facilement.
Récupérer les analyses d'apprentissage de la plateforme Didask afin de fusionner les données avec celles de votre LMS :
- Identité de l'utilisateur,
- Groupes,
- Publications auxquelles il a accès,
- Publications commencées,
- Publications terminées,
- % de complétion.
Gérer automatiquement certaines actions dans Didask en fonction de certaines données dans un système tiers :
- Créer un nouvel utilisateur,
- Créer un groupe,
- Ajouter un utilisateur à un groupe.
Afficher des informations sur votre site web. Par exemple, l'API vous permet d'afficher en temps réel le nombre d'apprenants qui ont réalisé une formation.

🛠 Comment ça marche ?

Vous aurez besoin de développeurs pour mettre en place l'API. Pour découvrir comment votre système peut s'interconnecter avec Didask, nous vous invitons à transmettre la documentation suivante à votre équipe technique : https://documenter.getpostman.com/view/15877277/2s8YCkgAzZ

Et les Connecteurs, qu'est-ce que c'est ?

Maintenant que vous visualisez ce qu’est une API, nous allons voir ce qu’est un connecteur.

Imaginez que vous êtes dans un restaurant en Inde et que vous ne parlez pas la langue locale. Le serveur, lui, ne parle pas français. Pour pouvoir passer commande, vous allez vous aider d’un ami qui va traduire. Cet ami va écouter votre commande, la traduire et la retranscrire au serveur du restaurant. Dans cette traduction, il ne va pas forcément faire une traduction mot à mot. Il va, par exemple, préciser que vous êtes étranger et donc plus sensible aux épices, demandant ainsi une version moins épicée.

Pourquoi utilise-t-on un connecteur ?

Compatibilité : Le connecteur (l’ami) permet de surmonter les barrières linguistiques entre vous et le serveur, assurant que votre commande est bien comprise. Vous pouvez ainsi manger en Inde sans souci. Cependant, si vous allez en Allemagne, il vous faudra un autre ami qui parle allemand (donc un autre connecteur).
Adaptation : Le connecteur permet d’intégrer des règles de gestion ou des contrôles afin que les messages passent correctement.

Remarque importante :
Les connecteurs existent physiquement quelque part. Dans notre exemple, il est avec vous car c’est votre ami. On peut très bien imaginer que ce connecteur soit en réalité un commis qui ait la capacité à traduire au chef ce que le serveur apporte comme commande. Dans ce cas, le connecteur serait “hébergé” en cuisine.

Mots-clés : API, automatisation, workflows, connecteurs

Sur le même thème, découvrez aussi :

Des questions supplémentaires ? N’hésitez pas à nous contacter à [email protected]. Notre équipe est à votre disposition pour vous aider et vous accompagner dans vos projets ! 💬