Reseptit

Tämä sivu on käännetty englannista. Jos ne eroavat toisistaan, englanninkielinen sivu on oikea. Lue englanninkielinen sivu

Resepti on yhteys, joka on nimetty sen mukaan, mitä haluat tehdä. Valitset sellaisen Sovellukset ja yhteydet -sivulla kohdassa “Rakenna yhteys” painettuasi “Aloita rakentaminen”. Ohjattu toiminto näyttää sitten vaiheensa yksi kerrallaan, ja jokainen vaihe tallentuu edetessäsi, joten voit poistua ja palata myöhemmin. Resepti, jota sovellus ei näytä sinulle, ei ole vielä käytettävissä tililläsi.

Jokainen resepti päättyy samoihin kahteen vaiheeseen, “Tarkistus” ja “Ota käyttöön”. Testi, kuiva-ajo ja käyttöönotto kuvaa ne.

Anna palvelimeni kutsua Lingaraa

Palvelimesi saa oman kirjautumisen ja salasanan, joten se voi käyttää Lingaraa puolestasi.

• Luo: kirjautumisen palvelimellesi (OAuth-asiakas) ja salasanan tälle kirjautumiselle (asiakkaan salaisuus).
• Vaiheet: “Nimi ja oikeudet”, “Tarkistus”, “Ota käyttöön”.
• Sen jälkeen: palvelimesi kirjautuu sisään tällä kirjautumisella ja sen salasanalla ja kutsuu sitten Lingaraa niillä oikeuksilla, jotka annoit sille kohdassa “Mitä se saa tehdä”.

Valinnainen skripti kirjautumisvaiheeseen; se säilyttää kirjoittamasi nimen ja merkitsee sen palvelimesi omaksi:

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

Kerro palvelimelleni, kun tuntisuunnitelma on valmis

Lingara lähettää palvelimellesi viestin aina, kun jokin tuntisuunnitelmistasi on valmis.

• Luo: kirjautumisen palvelimellesi, salasanan tälle kirjautumiselle ja viestit palvelimellesi (webhook-päätepiste).
• Vaiheet: “Nimi ja oikeudet”, “Minne lähetetään”, “Tarkistus”, “Ota käyttöön”.
• Sen jälkeen: palvelimesi vastaanottaa lesson_plan.ready-tapahtuman antamaasi https://-osoitteeseen. Jokainen viesti on allekirjoitettu: yksi käyttöönoton jälkeen näytetyistä salasanoista on se, jolla palvelimesi tarkistaa, että viesti todella tuli Lingaralta.

Valinnainen skripti vaiheeseen “Minne lähetetään”; se pyytää myös viestin, joka lähetetään, kun tuntisuunnitelmaa ei voitu luoda:

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

Näytä kortti Lingarassa

Sovelluksesi piirtää kortin Koti- tai Tuntisuunnitelmat-sivullesi.

• Luo: kirjautumisen palvelimellesi ja kortin Lingarassa (sovellusmanifesti).
• Vaiheet: “Nimi ja oikeudet”, “Korttisi”, “Tarkistus”, “Ota käyttöön”.
• Sen jälkeen: Lingara pyytää korttia osoitteesta, jonka annoit kohdassa “Missä sovelluksesi piirtää kortin”, ja sovelluksesi vastaa sillä. Yksi käyttöönoton jälkeen näytetyistä salasanoista on se, jolla sovelluksesi tarkistaa, että pyyntö todella tuli Lingaralta.

Valinnainen skripti vaiheeseen “Korttisi”; se näyttää kortin vain kotisivun sivupalstassa:

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