Ricette

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

Una ricetta è una connessione che prende il nome da ciò che vuoi fare. Ne scegli una in App e connessioni, sotto «Crea una connessione», dopo aver premuto «Inizia a creare». La procedura guidata mostra poi i suoi passaggi uno alla volta, e ogni passaggio viene salvato man mano che procedi, così puoi andartene e tornare. Una ricetta che l’app non ti mostra non è ancora disponibile per il tuo account.

Ogni ricetta termina con gli stessi due passaggi, «Controllo» e «Applica». Test, simulazione e applicazione li descrive.

Permetti al mio server di chiamare Lingara

Il tuo server ottiene un proprio accesso e una propria password, così può usare Lingara per te.

• Crea: un accesso per il tuo server (client OAuth) e una password per quell’accesso (segreto del client).
• Passaggi: «Nome e autorizzazioni», «Controllo», «Applica».
• Dopo: il tuo server accede con quell’accesso e la sua password, poi chiama Lingara con le autorizzazioni che gli hai dato in «Cosa può fare».

Uno script facoltativo per il passaggio dell’accesso, che mantiene il nome che hai digitato e lo contrassegna come quello del tuo server:

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

Avvisa il mio server quando un piano di lezione è pronto

Lingara invia un messaggio al tuo server ogni volta che uno dei tuoi piani di lezione è pronto.

• Crea: un accesso per il tuo server, una password per quell’accesso e messaggi al tuo server (endpoint webhook).
• Passaggi: «Nome e autorizzazioni», «Dove inviarlo», «Controllo», «Applica».
• Dopo: il tuo server riceve lesson_plan.ready all’indirizzo https:// che hai indicato. Ogni messaggio è firmato: una delle password mostrate dopo l’applicazione è quella che il tuo server usa per verificare che un messaggio provenga davvero da Lingara.

Uno script facoltativo per il passaggio «Dove inviarlo», che chiede anche il messaggio inviato quando non è stato possibile creare un piano di lezione:

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

Mostra una scheda dentro Lingara

La tua app disegna una scheda nella pagina Home o Piani di lezione.

• Crea: un accesso per il tuo server e una scheda dentro Lingara (manifest dell’app).
• Passaggi: «Nome e autorizzazioni», «La tua scheda», «Controllo», «Applica».
• Dopo: Lingara chiede la scheda all’indirizzo che hai indicato in «Dove la tua app disegna la scheda», e la tua app risponde con la scheda. Una delle password mostrate dopo l’applicazione è quella che la tua app usa per verificare che una richiesta provenga davvero da Lingara.

Uno script facoltativo per il passaggio «La tua scheda», che mostra la scheda solo nella colonna laterale della pagina Home:

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