Resep

Halaman ini diterjemahkan dari bahasa Inggris. Jika keduanya berbeda, halaman bahasa Inggris yang benar. Baca halaman bahasa Inggris

Resep adalah koneksi yang dinamai menurut hal yang ingin Anda lakukan. Anda memilihnya di Aplikasi & koneksi, di bawah “Buat koneksi”, setelah menekan “Mulai membuat”. Wizard lalu menampilkan langkah-langkahnya satu per satu, dan setiap langkah disimpan saat Anda berpindah, sehingga Anda dapat pergi dan kembali lagi. Resep yang tidak ditampilkan aplikasi kepada Anda belum tersedia di akun Anda.

Setiap resep diakhiri dengan dua langkah yang sama, “Periksa” dan “Terapkan”. Pengujian, simulasi, dan penerapan menjelaskan keduanya.

Izinkan server saya memanggil Lingara

Server Anda mendapatkan info masuk dan kata sandinya sendiri, sehingga dapat menggunakan Lingara atas nama Anda.

• Membuat: info masuk untuk server Anda (Klien OAuth), dan kata sandi untuk info masuk itu (Rahasia klien).
• Langkah: “Nama dan kemampuan”, “Periksa”, “Terapkan”.
• Setelahnya: server Anda masuk dengan info masuk itu dan kata sandinya, lalu memanggil Lingara dengan kemampuan yang Anda berikan di “Yang boleh dilakukannya”.

Skrip opsional untuk langkah info masuk, yang mempertahankan nama yang Anda ketik dan menandainya sebagai milik server Anda:

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

Beri tahu server saya saat rencana pelajaran siap

Lingara mengirimkan pesan ke server Anda setiap kali salah satu rencana pelajaran Anda siap.

• Membuat: info masuk untuk server Anda, kata sandi untuk info masuk itu, dan pesan ke server Anda (Titik akhir webhook).
• Langkah: “Nama dan kemampuan”, “Ke mana mengirimnya”, “Periksa”, “Terapkan”.
• Setelahnya: server Anda menerima lesson_plan.ready di alamat https:// yang Anda berikan. Setiap pesan ditandatangani: salah satu kata sandi yang ditampilkan setelah menerapkan adalah kata sandi yang digunakan server Anda untuk memeriksa bahwa pesan benar-benar berasal dari Lingara.

Skrip opsional untuk langkah “Ke mana mengirimnya”, yang juga meminta pesan yang dikirim ketika rencana pelajaran tidak dapat dibuat:

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

Tampilkan kartu di dalam Lingara

Aplikasi Anda menampilkan kartu di halaman Beranda atau Rencana pelajaran Anda.

• Membuat: info masuk untuk server Anda, dan kartu di dalam Lingara (Manifest aplikasi).
• Langkah: “Nama dan kemampuan”, “Kartu Anda”, “Periksa”, “Terapkan”.
• Setelahnya: Lingara meminta kartu ke alamat yang Anda berikan di “Tempat aplikasi Anda menampilkan kartu”, dan aplikasi Anda menjawab dengan kartu tersebut. Salah satu kata sandi yang ditampilkan setelah menerapkan adalah kata sandi yang digunakan aplikasi Anda untuk memeriksa bahwa permintaan benar-benar berasal dari Lingara.

Skrip opsional untuk langkah “Kartu Anda”, yang menampilkan kartu hanya di kolom samping halaman beranda:

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