Bien démarrer avec Lingara

Cette page est traduite de l'anglais. En cas de différence, la page anglaise fait foi. Lire la page en anglais

Connectez votre propre serveur ou application à votre compte Lingara sans écrire d’intégration de zéro. Vous choisissez une recette, remplissez quelques champs, vérifiez le résultat par rapport aux vraies règles de Lingara, puis vous l’appliquez. Les scripts sont facultatifs.

Ce que vous pouvez créer

Une connexion se compose de quatre éléments de base. Chacun est nommé ici avec les mots de l’application, accompagné du terme que Lingara utilise pour lui :

• Un identifiant pour votre serveur (client OAuth). Votre serveur l’utilise pour agir sur votre compte.
• Un mot de passe pour cet identifiant (secret du client). Vous le voyez une seule fois, juste après l’application.
• Des messages vers votre serveur (point de terminaison webhook). Lingara envoie un message à votre serveur quand quelque chose se produit, par exemple quand un plan de cours est prêt.
• Une carte dans Lingara (manifeste d’application). Votre application affiche une carte sur votre page Accueil ou Plans de cours.

Vous n’avez jamais à assembler ces éléments à la main. Une recette choisit les éléments et leur ordre, et « Vérifier » vous indique ce qui sera créé avant que quoi que ce soit ne le soit.

Prévenir mon serveur quand un plan de cours est prêt

Cette recette crée un identifiant, son mot de passe et les messages. Commencez dans l’application web et suivez les mots de l’assistant :

1. Dans Apps et connexions, sous « Créer une connexion », appuyez sur « Commencer » et choisissez « Prévenir mon serveur quand un plan de cours est prêt ».
2. Dans « Nom et capacités », nommez l’identifiant.
3. Dans « Destination », indiquez l’adresse https:// de votre serveur. Vous pouvez aussi ouvrir « Utiliser un script », coller le script ci-dessous et appuyer sur « Essayer ».
4. Dans « Vérification », appuyez sur « Vérifier » et lisez « Voici ce qui sera créé ».
5. Appuyez sur « Appliquer » et copiez chaque mot de passe dès qu’il apparaît. Chacun n’est affiché qu’une seule fois.
6. Générez un plan de cours et regardez votre serveur recevoir lesson_plan.ready.

Le script est facultatif. Celui-ci fait ce que font les champs, et ajoute le message que Lingara envoie quand un plan de cours n’a pas pu être créé :

return lingara.webhook({ client: input.client, url: input.url, events: ['lesson_plan.ready', 'lesson_plan.failed'] })

Et ensuite

• Recettes décrit les trois recettes et ce qu’il faut faire de ce que chacune crée.
• Tester, simuler et appliquer explique ce que vérifie « Vérifier » et ce que fait « Appliquer ».
• Documentation développeur de Lingara liste tout ce qu’un script peut appeler.
• Tout ce qu’une connexion crée, vous pouvez aussi le créer à la main dans les Outils de développement, dans l’application web.