Aan de slag met Lingara

Deze pagina is vertaald uit het Engels. Als de twee verschillen, is de Engelse pagina juist. Lees de Engelse pagina

Koppel je eigen server of app aan je Lingara-account zonder vanaf nul een integratie te schrijven. Je kiest een recept, vult een paar velden in, controleert het resultaat tegen de echte regels van Lingara en past het daarna toe. Scripts zijn optioneel.

Wat je kunt bouwen

Een koppeling bestaat uit vier bouwstenen. Elk wordt hier genoemd met de woorden van de app, met de term die Lingara ervoor gebruikt ernaast:

• Een aanmelding voor je server (OAuth-client). Je server gebruikt die om namens je account te handelen.
• Een wachtwoord voor die aanmelding (clientgeheim). Je ziet het één keer, direct na het toepassen.
• Berichten naar je server (webhook-endpoint). Lingara stuurt je server een bericht wanneer er iets gebeurt, bijvoorbeeld wanneer een lesplan klaar is.
• Een kaart in Lingara (app-manifest). Je app tekent een kaart op je pagina Home of Lesplannen.

Je hoeft deze nooit met de hand samen te stellen. Een recept kiest de bouwstenen en de volgorde, en “Controleren” vertelt je wat er gemaakt wordt voordat er ook maar iets gemaakt is.

Mijn server laten weten wanneer een lesplan klaar is

Dit recept maakt een aanmelding, het wachtwoord ervan en de berichten. Begin in de webapp en volg de woorden van de wizard zelf:

1. Druk op Apps & koppelingen, onder “Een koppeling bouwen”, op “Beginnen met bouwen” en kies “Mijn server laten weten wanneer een lesplan klaar is”.
2. Geef in “Naam en mogelijkheden” de aanmelding een naam.
3. Geef in “Waar het naartoe gaat” het https://-adres van je server op. Je kunt ook “Een script gebruiken” openen, het script hieronder plakken en op “Uitproberen” drukken.
4. Druk in “Controleren” op “Controleren” en lees “Dit wordt er gemaakt”.
5. Druk op “Toepassen” en kopieer elk wachtwoord zodra het verschijnt. Elk wachtwoord wordt één keer getoond.
6. Genereer een lesplan en kijk hoe je server lesson_plan.ready ontvangt.

Het script is optioneel. Dit script doet wat de velden doen, en voegt het bericht toe dat Lingara stuurt wanneer een lesplan niet kon worden gemaakt:

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

Wat nu

• Recepten beschrijft alle drie de recepten en wat je doet met wat elk ervan maakt.
• Testen, proefdraaien en toepassen legt uit wat “Controleren” controleert en wat “Toepassen” doet.
• Lingara-ontwikkelaarsdocumentatie somt alles op wat een script kan aanroepen.
• Alles wat een koppeling maakt, kun je ook met de hand maken in Ontwikkelaarstools, in de webapp.