Lingaran aloitusopas

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

Yhdistä oma palvelimesi tai sovelluksesi Lingara-tiliisi kirjoittamatta integraatiota alusta asti. Valitset reseptin, täytät muutaman kentän, tarkistat tuloksen Lingaran todellisia sääntöjä vasten ja otat sen sitten käyttöön. Skriptit ovat valinnaisia.

Mitä voit rakentaa

Yhteys koostuu neljästä rakennuspalikasta. Jokainen nimetään tässä sovelluksen omin sanoin, ja sen vieressä on termi, jota Lingara siitä käyttää:

• Kirjautuminen palvelimellesi (OAuth-asiakas). Palvelimesi käyttää sitä toimiakseen tilisi puolesta.
• Salasana tälle kirjautumiselle (asiakkaan salaisuus). Näet sen kerran, heti käyttöönoton jälkeen.
• Viestit palvelimellesi (webhook-päätepiste). Lingara lähettää palvelimellesi viestin, kun jotain tapahtuu, esimerkiksi kun tuntisuunnitelma on valmis.
• Kortti Lingarassa (sovellusmanifesti). Sovelluksesi piirtää kortin Koti- tai Tuntisuunnitelmat-sivullesi.

Sinun ei koskaan tarvitse koota näitä käsin. Resepti valitsee palikat ja niiden järjestyksen, ja “Tarkista” kertoo, mitä luodaan, ennen kuin mitään luodaan.

Kerro palvelimelleni, kun tuntisuunnitelma on valmis

Tämä resepti luo kirjautumisen, sen salasanan ja viestit. Aloita verkkosovelluksessa ja seuraa ohjatun toiminnon omia sanoja:

1. Paina Sovellukset ja yhteydet -sivulla kohdassa “Rakenna yhteys” painiketta “Aloita rakentaminen” ja valitse “Kerro palvelimelleni, kun tuntisuunnitelma on valmis”.
2. Nimeä kirjautuminen vaiheessa “Nimi ja oikeudet”.
3. Anna vaiheessa “Minne lähetetään” palvelimesi https://-osoite. Voit myös avata kohdan “Käytä skriptiä”, liittää alla olevan skriptin ja painaa “Kokeile”.
4. Paina vaiheessa “Tarkistus” painiketta “Tarkista” ja lue “Tämä luodaan”.
5. Paina “Ota käyttöön” ja kopioi jokainen salasana sitä mukaa kuin se tulee näkyviin. Jokainen näytetään vain kerran.
6. Luo tuntisuunnitelma ja katso, kun palvelimesi vastaanottaa lesson_plan.ready-tapahtuman.

Skripti on valinnainen. Tämä skripti tekee saman kuin kentät ja lisää viestin, jonka Lingara lähettää, kun tuntisuunnitelmaa ei voitu luoda:

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

Mitä seuraavaksi

• Reseptit kuvaa kaikki kolme reseptiä ja sen, mitä kunkin luomilla asioilla tehdään.
• Testi, kuiva-ajo ja käyttöönotto selittää, mitä “Tarkista” tarkistaa ja mitä “Ota käyttöön” tekee.
• Lingara-kehittäjädokumentaatio luettelee kaiken, mitä skripti voi kutsua.
• Kaiken, minkä yhteys luo, voit tehdä myös käsin Kehittäjätyökaluissa verkkosovelluksessa.