Vorlagen

Diese Seite ist aus dem Englischen übersetzt. Wenn die beiden voneinander abweichen, ist die englische Seite maßgeblich. Englische Seite lesen

Eine Vorlage ist eine Verbindung, die nach dem benannt ist, was Sie tun möchten. Sie wählen eine unter Apps & Verbindungen bei „Verbindung erstellen“, nachdem Sie „Loslegen“ gedrückt haben. Der Assistent zeigt dann ihre Schritte einzeln an, und jeder Schritt wird gespeichert, während Sie weitergehen, sodass Sie aufhören und später zurückkehren können. Eine Vorlage, die die App Ihnen nicht zeigt, ist für Ihr Konto noch nicht verfügbar.

Jede Vorlage endet mit denselben zwei Schritten, „Prüfen“ und „Übernehmen“. Testen, Probelauf und Übernehmen beschreibt sie.

Meinen Server Lingara aufrufen lassen

Ihr Server bekommt eine eigene Anmeldung und ein eigenes Passwort, damit er Lingara für Sie nutzen kann.

• Erstellt: eine Anmeldung für Ihren Server (OAuth-Client) und ein Passwort für diese Anmeldung (Client-Secret).
• Schritte: „Name und Fähigkeiten“, „Prüfen“, „Übernehmen“.
• Danach: Ihr Server meldet sich mit dieser Anmeldung und ihrem Passwort an und ruft Lingara dann mit den Fähigkeiten auf, die Sie ihm unter „Was sie darf“ gegeben haben.

Ein optionales Skript für den Anmeldeschritt, das den eingegebenen Namen beibehält und ihn als den Ihres Servers kennzeichnet:

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

Meinem Server melden, wenn ein Lektionsplan fertig ist

Lingara schickt Ihrem Server jedes Mal eine Nachricht, wenn einer Ihrer Lektionspläne fertig ist.

• Erstellt: eine Anmeldung für Ihren Server, ein Passwort für diese Anmeldung und Nachrichten an Ihren Server (Webhook-Endpunkt).
• Schritte: „Name und Fähigkeiten“, „Wohin senden“, „Prüfen“, „Übernehmen“.
• Danach: Ihr Server empfängt lesson_plan.ready unter der https://-Adresse, die Sie angegeben haben. Jede Nachricht ist signiert: Eines der nach dem Übernehmen angezeigten Passwörter ist das, mit dem Ihr Server prüft, dass eine Nachricht wirklich von Lingara kommt.

Ein optionales Skript für den Schritt „Wohin senden“, das zusätzlich die Nachricht anfordert, die gesendet wird, wenn ein Lektionsplan nicht erstellt werden konnte:

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

Eine Karte in Lingara anzeigen

Ihre App zeichnet eine Karte auf Ihre Startseite oder die Seite „Lektionspläne“.

• Erstellt: eine Anmeldung für Ihren Server und eine Karte in Lingara (App-Manifest).
• Schritte: „Name und Fähigkeiten“, „Deine Karte“, „Prüfen“, „Übernehmen“.
• Danach: Lingara fragt die Adresse, die Sie unter „Wo deine App die Karte zeichnet“ angegeben haben, nach der Karte, und Ihre App antwortet damit. Eines der nach dem Übernehmen angezeigten Passwörter ist das, mit dem Ihre App prüft, dass eine Anfrage wirklich von Lingara kommt.

Ein optionales Skript für den Schritt „Deine Karte“, das die Karte nur in der Seitenspalte der Startseite zeigt:

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