Recepten

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

Een recept is een koppeling die genoemd is naar wat je wilt doen. Je kiest er een op Apps & koppelingen, onder “Een koppeling bouwen”, nadat je op “Beginnen met bouwen” hebt gedrukt. De wizard toont dan de stappen een voor een, en elke stap wordt opgeslagen terwijl je verdergaat, zodat je kunt weggaan en later terugkomen. Een recept dat de app je niet toont, is nog niet beschikbaar voor je account.

Elk recept eindigt met dezelfde twee stappen, “Controleren” en “Toepassen”. Testen, proefdraaien en toepassen beschrijft ze.

Mijn server Lingara laten aanroepen

Je server krijgt een eigen aanmelding en wachtwoord, zodat hij Lingara voor je kan gebruiken.

• Maakt: een aanmelding voor je server (OAuth-client) en een wachtwoord voor die aanmelding (clientgeheim).
• Stappen: “Naam en mogelijkheden”, “Controleren”, “Toepassen”.
• Daarna: je server meldt zich aan met die aanmelding en het wachtwoord ervan, en roept Lingara vervolgens aan met de mogelijkheden die je hem gaf in “Wat hij mag doen”.

Een optioneel script voor de aanmeldingsstap, dat de naam die je typte behoudt en hem markeert als die van je server:

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

Mijn server laten weten wanneer een lesplan klaar is

Lingara stuurt je server een bericht telkens wanneer een van je lesplannen klaar is.

• Maakt: een aanmelding voor je server, een wachtwoord voor die aanmelding en berichten naar je server (webhook-endpoint).
• Stappen: “Naam en mogelijkheden”, “Waar het naartoe gaat”, “Controleren”, “Toepassen”.
• Daarna: je server ontvangt lesson_plan.ready op het https://-adres dat je opgaf. Elk bericht is ondertekend: een van de wachtwoorden die na het toepassen worden getoond, is het wachtwoord waarmee je server controleert dat een bericht echt van Lingara kwam.

Een optioneel script voor de stap “Waar het naartoe gaat”, dat ook vraagt om het bericht dat wordt verstuurd wanneer een lesplan niet kon worden gemaakt:

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

Een kaart in Lingara tonen

Je app tekent een kaart op je pagina Home of Lesplannen.

• Maakt: een aanmelding voor je server en een kaart in Lingara (app-manifest).
• Stappen: “Naam en mogelijkheden”, “Je kaart”, “Controleren”, “Toepassen”.
• Daarna: Lingara vraagt het adres dat je opgaf in “Waar je app de kaart tekent” om de kaart, en je app antwoordt ermee. Een van de wachtwoorden die na het toepassen worden getoond, is het wachtwoord waarmee je app controleert dat een verzoek echt van Lingara kwam.

Een optioneel script voor de stap “Je kaart”, dat de kaart alleen toont in de zijkolom van de startpagina:

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