Tämä sivu on käännetty englannista. Jos ne eroavat toisistaan, englanninkielinen sivu on oikea. Lue englanninkielinen sivu
Sovelluksesi saa tietää oppijasta vain kontekstiosioiden kautta. Kukin osio on pieni tietue, jolla on kiinteät kentät. Manifestisi luettelee osiot, joita se pyytää, oppija suostuu kuhunkin niistä asentaessaan sovelluksesi, ja Lingara lähettää osion vain niin kauan kuin molemmat ovat yhä voimassa.
Osiot
Osio
Kenttä
Mitä se sisältää
languages
source_lang
Kieli, josta käsin oppija opiskelee, kielitunnisteena, kuten en.
target_lang
Kieli, jota hän opettelee.
level
Hänen tasonsa siinä, väliltä 1–9, jos hän on asettanut sen.
plan_summary
plan_id
Hänen viimeisimmän tuntisuunnitelmansa tunniste, joka erottaa suunnitelman toisesta. Sovelluksesi ei voi hakea suunnitelmaa sillä, koska sovelluksesi tunnus lukee omaa tiliäsi, ei oppijan tiliä.
title
Suunnitelman generoitu otsikko, enintään 120 merkkiä, jos sillä on sellainen.
target_lang
Kieli, jota suunnitelma opettaa.
set_count
Kuinka monta sarjaa suunnitelmassa on, enintään 200.
sets_completed
Kuinka monta näistä sarjoista oppija on suorittanut.
review_due
due
Kuinka monta muistikorttia on nyt kerrattavana, enintään 100000.
learned
Kuinka monta sanaa hän on oppinut, enintään 100000.
tutor_topic
topic
Mistä hänen viimeisin tutorkeskustelunsa kertoo, 1–120 merkkiä. Se tulee suunnitelman otsikosta tai näkymästä, jossa hän on, ei koskaan hänen omista sanoistaan.
Mitä mikään osio ei sisällä
Mikään osio ei sisällä sähköpostiosoitetta, nimeä, käyttäjätunnistetta tai mitään, mitä oppija on kirjoittanut. Sovelluksesi saa tietää, kuka oppija on, pyynnön subject-arvosta, joka on pysyvä ja eri jokaiselle sovellukselle. Sovelluksesi tunnus lukee omaa tiliäsi, ei koskaan oppijan tiliä, joten osiot ovat kaikki, mitä sovelluksesi hänestä tietää.
Suostumus
Oppija suostuu kuhunkin osioon asentaessaan sovelluksesi. Muuttaakseen sitä, mihin hän suostui, hän poistaa sovelluksesi asennuksen ja asentaa sen uudelleen.
Jos muokkaat manifestiasi pyytämään vähemmän osioita, pois jättämäsi osiot lakkaavat heti.
Jos muokkaat sitä pyytämään enemmän, uudet osiot eivät tavoita yhtään oppijaa ennen kuin hän asentaa sovelluksen uudelleen.
Lingara tarkistaa suostumuksen uudelleen jokaisen pyynnön yhteydessä ja pudottaa pois jokaisen osion, johon oppija ei suostunut tai jota manifestisi ei enää pyydä. Myös osio, joka ei sovi tietueeseensa, pudotetaan pois, ei koskaan koko pyyntöä.
Alla oleva esimerkki muodostaa rivinsä saamistaan osioista eikä kutsu mitään API:a.