Recettes

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

Une recette est une connexion nommée d’après ce que vous voulez faire. Vous en choisissez une dans Apps et connexions, sous « Créer une connexion », après avoir appuyé sur « Commencer ». L’assistant affiche ensuite ses étapes une à une, et chaque étape est enregistrée à mesure que vous avancez : vous pouvez donc partir et revenir. Une recette que l’application ne vous montre pas n’est pas encore disponible sur votre compte.

Chaque recette se termine par les deux mêmes étapes, « Vérification » et « Appliquer ». Tester, simuler et appliquer les décrit.

Permettre à mon serveur d’appeler Lingara

Votre serveur obtient son propre identifiant et son propre mot de passe, pour pouvoir utiliser Lingara à votre place.

• Crée : un identifiant pour votre serveur (client OAuth) et un mot de passe pour cet identifiant (secret du client).
• Étapes : « Nom et capacités », « Vérification », « Appliquer ».
• Ensuite : votre serveur se connecte avec cet identifiant et son mot de passe, puis appelle Lingara avec les capacités que vous lui avez données dans « Ce qu’il peut faire ».

Un script facultatif pour l’étape de l’identifiant, qui garde le nom que vous avez saisi et le marque comme celui de votre serveur :

return lingara.client({ name: input.name + ' (server)', scopes: input.scopes })

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

Lingara envoie un message à votre serveur chaque fois que l’un de vos plans de cours est prêt.

• Crée : un identifiant pour votre serveur, un mot de passe pour cet identifiant et des messages vers votre serveur (point de terminaison webhook).
• Étapes : « Nom et capacités », « Destination », « Vérification », « Appliquer ».
• Ensuite : votre serveur reçoit lesson_plan.ready à l’adresse https:// que vous avez indiquée. Chaque message est signé : l’un des mots de passe affichés après l’application est celui que votre serveur utilise pour vérifier qu’un message vient bien de Lingara.

Un script facultatif pour l’étape « Destination », qui demande aussi le message envoyé quand un plan de cours n’a pas pu être créé :

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

Afficher une carte dans Lingara

Votre application affiche une carte sur votre page Accueil ou Plans de cours.

• Crée : un identifiant pour votre serveur et une carte dans Lingara (manifeste d’application).
• Étapes : « Nom et capacités », « Votre carte », « Vérification », « Appliquer ».
• Ensuite : Lingara demande la carte à l’adresse que vous avez indiquée dans « Où votre application affiche la carte », et votre application la lui renvoie. L’un des mots de passe affichés après l’application est celui que votre application utilise pour vérifier qu’une requête vient bien de Lingara.

Un script facultatif pour l’étape « Votre carte », qui n’affiche la carte que dans la colonne latérale de la page d’accueil :

return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })