Tarifler

Bu sayfa İngilizceden çevrilmiştir. İkisi arasında fark varsa İngilizce sayfa doğrudur. İngilizce sayfayı oku

Tarif, yapmak istediğiniz şeye göre adlandırılmış bir bağlantıdır. “Oluşturmaya başla” düğmesine bastıktan sonra Uygulamalar ve bağlantılar sayfasında, “Bağlantı oluştur” altında bir tane seçersiniz. Sihirbaz ardından adımlarını tek tek gösterir ve her adım siz ilerledikçe kaydedilir; böylece ayrılıp daha sonra geri dönebilirsiniz. Uygulamanın size göstermediği bir tarif henüz hesabınızda kullanılamıyor demektir.

Her tarif aynı iki adımla biter: “Kontrol” ve “Uygula”. Test, deneme çalıştırması ve uygulama bu adımları anlatır.

Sunucum Lingara’yı çağırabilsin

Sunucunuz kendi oturum açma bilgisini ve parolasını alır; böylece Lingara’yı sizin adınıza kullanabilir.

• Oluşturdukları: sunucunuz için bir oturum açma bilgisi (OAuth istemcisi) ve bu oturum açma bilgisi için bir parola (istemci gizli anahtarı).
• Adımlar: “Ad ve yetkiler”, “Kontrol”, “Uygula”.
• Sonrasında: sunucunuz bu oturum açma bilgisi ve parolasıyla oturum açar, ardından “Neler yapabilir” bölümünde ona verdiğiniz yetkilerle Lingara’yı çağırır.

Oturum açma adımı için isteğe bağlı bir betik; yazdığınız adı korur ve onu sunucunuza ait olarak işaretler:

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

Bir ders planı hazır olduğunda sunucuma haber ver

Ders planlarınızdan biri her hazır olduğunda Lingara sunucunuza bir mesaj gönderir.

• Oluşturdukları: sunucunuz için bir oturum açma bilgisi, bu oturum açma bilgisi için bir parola ve sunucunuza mesajlar (webhook uç noktası).
• Adımlar: “Ad ve yetkiler”, “Nereye gönderilecek”, “Kontrol”, “Uygula”.
• Sonrasında: sunucunuz lesson_plan.ready mesajını verdiğiniz https:// adresinde alır. Her mesaj imzalıdır: uyguladıktan sonra gösterilen parolalardan biri, sunucunuzun bir mesajın gerçekten Lingara’dan geldiğini kontrol etmek için kullandığı paroladır.

“Nereye gönderilecek” adımı için isteğe bağlı bir betik; bir ders planı oluşturulamadığında gönderilen mesajı da ister:

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

Lingara içinde bir kart göster

Uygulamanız Ana Sayfa veya Ders Planları sayfanızda bir kart çizer.

• Oluşturdukları: sunucunuz için bir oturum açma bilgisi ve Lingara içinde bir kart (uygulama manifestosu).
• Adımlar: “Ad ve yetkiler”, “Kartınız”, “Kontrol”, “Uygula”.
• Sonrasında: Lingara kartı, “Uygulamanızın kartı çizdiği yer” alanına verdiğiniz adresten ister ve uygulamanız kartla yanıt verir. Uyguladıktan sonra gösterilen parolalardan biri, uygulamanızın bir isteğin gerçekten Lingara’dan geldiğini kontrol etmek için kullandığı paroladır.

“Kartınız” adımı için isteğe bağlı bir betik; kartı yalnızca ana sayfanın yan sütununda gösterir:

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