دستورالعمل‌ها

این صفحه از انگلیسی ترجمه شده است. اگر این دو با هم فرق داشته باشند، صفحهٔ انگلیسی درست است. صفحهٔ انگلیسی را بخوانید

دستورالعمل اتصالی است که به نام کاری که می‌خواهید انجام دهید نام‌گذاری شده است. یکی را در برنامه‌ها و اتصالات، زیر «ساختن یک اتصال»، پس از فشار دادن «آغاز ساختن» انتخاب می‌کنید. سپس رهنما مرحله‌های آن را یکی یکی نشان می‌دهد و هر مرحله در جریان حرکت شما ذخیره می‌شود، پس می‌توانید بروید و دوباره برگردید. دستورالعملی که اپلیکیشن به شما نشان نمی‌دهد هنوز در حساب شما در دسترس نیست.

هر دستورالعمل با همان دو مرحله، «بررسی» و «اعمال»، پایان می‌یابد. آزمایش، اجرای آزمایشی و اعمال آن‌ها را شرح می‌دهد.

سرورم بتواند Lingara را فراخوانی کند

سرور شما ورود و رمز عبور خودش را می‌گیرد، تا بتواند از طرف شما از Lingara استفاده کند.

• می‌سازد: یک ورود برای سرور شما (کلاینت OAuth)، و یک رمز عبور برای آن ورود (رمز کلاینت).
• مرحله‌ها: «نام و توانایی‌ها»، «بررسی»، «اعمال».
• پس از آن: سرور شما با آن ورود و رمز عبورش وارد می‌شود و سپس Lingara را با توانایی‌هایی که در «چه کارهایی کرده می‌تواند» به آن داده‌اید فراخوانی می‌کند.

یک اسکریپت اختیاری برای مرحلهٔ ورود، که نامی را که تایپ کرده‌اید نگه می‌دارد و آن را به عنوان از سرور شما نشانی می‌کند:

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

وقتی یک برنامهٔ درسی آماده شد، به سرورم خبر بده

هر بار که یکی از برنامه‌های درسی شما آماده شود، Lingara یک پیام به سرور شما می‌فرستد.

• می‌سازد: یک ورود برای سرور شما، یک رمز عبور برای آن ورود، و پیام به سرور شما (نقطهٔ پایانی وب‌هوک).
• مرحله‌ها: «نام و توانایی‌ها»، «به کجا فرستاده شود»، «بررسی»، «اعمال».
• پس از آن: سرور شما lesson_plan.ready را در آدرس https:// که داده‌اید دریافت می‌کند. هر پیام امضا شده است: یکی از رمزهای عبوری که پس از اعمال نشان داده می‌شود همان است که سرور شما برای بررسی اینکه پیام واقعاً از Lingara آمده است به کار می‌برد.

یک اسکریپت اختیاری برای مرحلهٔ «به کجا فرستاده شود»، که پیامی را هم که وقتی یک برنامهٔ درسی ساخته نشود فرستاده می‌شود درخواست می‌کند:

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

نمایش یک کارت درون Lingara

اپلیکیشن شما یک کارت را در صفحهٔ خانه یا برنامه‌های درسی شما ترسیم می‌کند.

• می‌سازد: یک ورود برای سرور شما، و یک کارت درون Lingara (مانیفست برنامه).
• مرحله‌ها: «نام و توانایی‌ها»، «کارت شما»، «بررسی»، «اعمال».
• پس از آن: Lingara کارت را از آدرسی که در «جایی که برنامهٔ شما کارت را ترسیم می‌کند» داده‌اید درخواست می‌کند و اپلیکیشن شما با آن پاسخ می‌دهد. یکی از رمزهای عبوری که پس از اعمال نشان داده می‌شود همان است که اپلیکیشن شما برای بررسی اینکه درخواست واقعاً از Lingara آمده است به کار می‌برد.

یک اسکریپت اختیاری برای مرحلهٔ «کارت شما»، که کارت را فقط در ستون کناری صفحهٔ خانه نشان می‌دهد:

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