Primi passi con Lingara

Questa pagina è tradotta dall'inglese. Se le due versioni differiscono, fa fede la pagina in inglese. Leggi la pagina in inglese

Collega il tuo server o la tua app al tuo account Lingara senza scrivere un’integrazione da zero. Scegli una ricetta, compili alcuni campi, controlli il risultato rispetto alle regole reali di Lingara e poi lo applichi. Gli script sono facoltativi.

Cosa puoi creare

Una connessione è composta da quattro elementi di base. Ognuno è indicato qui con le parole dell’app, accanto al termine che Lingara usa per esso:

• Un accesso per il tuo server (client OAuth). Il tuo server lo usa per agire sul tuo account.
• Una password per quell’accesso (segreto del client). La vedi una sola volta, subito dopo aver applicato.
• Messaggi al tuo server (endpoint webhook). Lingara invia un messaggio al tuo server quando succede qualcosa, ad esempio quando un piano di lezione è pronto.
• Una scheda dentro Lingara (manifest dell’app). La tua app disegna una scheda nella pagina Home o Piani di lezione.

Non devi mai mettere insieme questi elementi a mano. Una ricetta sceglie gli elementi e il loro ordine, e «Controlla» ti dice cosa verrà creato prima che venga creato qualsiasi cosa.

Avvisa il mio server quando un piano di lezione è pronto

Questa ricetta crea un accesso, la sua password e i messaggi. Inizia dall’app web e segui le parole della procedura guidata:

1. In App e connessioni, sotto «Crea una connessione», premi «Inizia a creare» e scegli «Avvisa il mio server quando un piano di lezione è pronto».
2. In «Nome e autorizzazioni», dai un nome all’accesso.
3. In «Dove inviarlo», indica l’indirizzo https:// del tuo server. Puoi anche aprire «Usa uno script», incollare lo script qui sotto e premere «Provalo».
4. In «Controllo», premi «Controlla» e leggi «Ecco cosa verrà creato».
5. Premi «Applica» e copia ogni password appena compare. Ognuna viene mostrata una sola volta.
6. Genera un piano di lezione e guarda il tuo server ricevere lesson_plan.ready.

Lo script è facoltativo. Questo fa ciò che fanno i campi e aggiunge il messaggio che Lingara invia quando non è stato possibile creare un piano di lezione:

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

E poi

• Ricette descrive tutte e tre le ricette e cosa fare con ciò che ognuna crea.
• Test, simulazione e applicazione spiega cosa verifica «Controlla» e cosa fa «Applica».
• Documentazione per sviluppatori di Lingara elenca tutto ciò che uno script può chiamare.
• Tutto ciò che una connessione crea puoi crearlo anche a mano in Strumenti per sviluppatori, nell’app web.