Erste Schritte mit Lingara

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

Verbinden Sie Ihren eigenen Server oder Ihre App mit Ihrem Lingara-Konto, ohne eine Integration von Grund auf zu schreiben. Sie wählen eine Vorlage, füllen ein paar Felder aus, prüfen das Ergebnis gegen die echten Regeln von Lingara und übernehmen es dann. Skripte sind optional.

Was Sie erstellen können

Eine Verbindung besteht aus vier Bausteinen. Jeder ist hier mit den Worten der App benannt, daneben der Begriff, den Lingara dafür verwendet:

• Eine Anmeldung für Ihren Server (OAuth-Client). Ihr Server handelt damit in Ihrem Konto.
• Ein Passwort für diese Anmeldung (Client-Secret). Sie sehen es einmal, direkt nach dem Übernehmen.
• Nachrichten an Ihren Server (Webhook-Endpunkt). Lingara schickt Ihrem Server eine Nachricht, wenn etwas passiert, etwa wenn ein Lektionsplan fertig ist.
• Eine Karte in Lingara (App-Manifest). Ihre App zeichnet eine Karte auf Ihre Startseite oder die Seite „Lektionspläne“.

Sie müssen diese Bausteine nie von Hand zusammensetzen. Eine Vorlage wählt die Bausteine und ihre Reihenfolge, und „Prüfen“ zeigt Ihnen, was erstellt wird, bevor irgendetwas erstellt ist.

Meinem Server melden, wenn ein Lektionsplan fertig ist

Diese Vorlage erstellt eine Anmeldung, ihr Passwort und die Nachrichten. Beginnen Sie in der Web-App und folgen Sie den Worten des Assistenten:

1. Drücken Sie unter Apps & Verbindungen bei „Verbindung erstellen“ auf „Loslegen“ und wählen Sie „Meinem Server melden, wenn ein Lektionsplan fertig ist“.
2. Benennen Sie unter „Name und Fähigkeiten“ die Anmeldung.
3. Geben Sie unter „Wohin senden“ die https://-Adresse Ihres Servers an. Sie können auch „Ein Skript verwenden“ öffnen, das Skript unten einfügen und „Ausprobieren“ drücken.
4. Drücken Sie unter „Prüfen“ auf „Prüfen“ und lesen Sie „Das wird erstellt“.
5. Drücken Sie „Übernehmen“ und kopieren Sie jedes Passwort, sobald es erscheint. Jedes wird nur einmal angezeigt.
6. Erzeugen Sie einen Lektionsplan und sehen Sie zu, wie Ihr Server lesson_plan.ready empfängt.

Das Skript ist optional. Dieses hier tut, was die Felder tun, und fügt die Nachricht hinzu, die Lingara sendet, wenn ein Lektionsplan nicht erstellt werden konnte:

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

Wie es weitergeht

• Vorlagen beschreibt alle drei Vorlagen und was Sie mit dem anfangen, was jede erstellt.
• Testen, Probelauf und Übernehmen erklärt, was „Prüfen“ prüft und was „Übernehmen“ tut.
• Lingara-Entwicklerdokumentation listet alles auf, was ein Skript aufrufen kann.
• Alles, was eine Verbindung erstellt, können Sie auch von Hand in den Entwicklertools in der Web-App erstellen.