آغاز کار با Lingara
این صفحه از انگلیسی ترجمه شده است. اگر این دو با هم فرق داشته باشند، صفحهٔ انگلیسی درست است. صفحهٔ انگلیسی را بخوانید
سرور یا اپلیکیشن خود را بدون نوشتن یک یکپارچهسازی از صفر با حساب Lingara خود وصل کنید. یک دستورالعمل را انتخاب میکنید، چند خانه را پر میکنید، نتیجه را با قواعد واقعی Lingara بررسی میکنید و سپس آن را اعمال میکنید. اسکریپتها اختیاری هستند.
چه چیزهایی ساخته میتوانید
یک اتصال از چهار بلاک ساختمانی تشکیل میشود. هر کدام در اینجا با کلمات خود اپلیکیشن نام برده شده و اصطلاحی که Lingara برای آن به کار میبرد در کنارش آمده است:
- یک ورود برای سرور شما (کلاینت OAuth). سرور شما با آن از طرف حساب شما کار میکند.
- یک رمز عبور برای آن ورود (رمز کلاینت). آن را فقط یک بار، درست پس از اعمال، میبینید.
- پیام به سرور شما (نقطهٔ پایانی وبهوک). وقتی چیزی رخ دهد، مثلاً یک برنامهٔ درسی آماده شود، Lingara یک پیام به سرور شما میفرستد.
- یک کارت درون Lingara (مانیفست برنامه). اپلیکیشن شما یک کارت را در صفحهٔ خانه یا برنامههای درسی شما ترسیم میکند.
هرگز لازم نیست اینها را با دست کنار هم بگذارید. دستورالعمل بلاکها و ترتیب آنها را انتخاب میکند، و «بررسی کنید» پیش از ساخته شدن هر چیزی به شما میگوید چه چیزی ساخته خواهد شد.
وقتی یک برنامهٔ درسی آماده شد، به سرورم خبر بده
این دستورالعمل یک ورود، رمز عبور آن و پیامها را میسازد. در اپلیکیشن ویب آغاز کنید و کلمات خود رهنما را دنبال کنید:
- در برنامهها و اتصالات، زیر «ساختن یک اتصال»، «آغاز ساختن» را فشار دهید و «وقتی یک برنامهٔ درسی آماده شد، به سرورم خبر بده» را انتخاب کنید.
- در «نام و تواناییها»، برای ورود یک نام بگذارید.
- در «به کجا فرستاده شود»، آدرس
https://سرور خود را وارد کنید. همچنین میتوانید «استفاده از اسکریپت» را باز کنید، اسکریپت پایین را بچسپانید و «امتحان کنید» را فشار دهید. - در «بررسی»، «بررسی کنید» را فشار دهید و «این چیزی است که ساخته خواهد شد» را بخوانید.
- «اعمال» را فشار دهید و هر رمز عبور را همان لحظه که ظاهر میشود کاپی کنید. هر کدام فقط یک بار نشان داده میشود.
- یک برنامهٔ درسی بسازید و ببینید که سرور شما
lesson_plan.readyرا دریافت میکند.
اسکریپت اختیاری است. این اسکریپت همان کاری را میکند که خانهها میکنند، و پیامی را هم اضافه میکند که Lingara وقتی یک برنامهٔ درسی ساخته نشود میفرستد:
return lingara.webhook({ client: input.client, url: input.url, events: ['lesson_plan.ready', 'lesson_plan.failed'] })
قدم بعدی
- دستورالعملها هر سه دستورالعمل را شرح میدهد و اینکه با آنچه هر کدام میسازد چه کنید.
- آزمایش، اجرای آزمایشی و اعمال توضیح میدهد که «بررسی کنید» چه چیزی را بررسی میکند و «اعمال» چه میکند.
- اسناد انکشافدهندگان Lingara هر چیزی را که یک اسکریپت فراخوانی کرده میتواند فهرست میکند.
- هر چیزی را که یک اتصال میسازد، میتوانید با دست هم در ابزارهای انکشافدهنده، در اپلیکیشن ویب، بسازید.
همچنین ببینید
ساختن اتصالها
- دستورالعملها
سه دستورالعمل، آنچه هر کدام میسازد، مرحلههای آن به ترتیب، و اینکه با نتیجه چه کنید.
- آزمایش، اجرای آزمایشی و اعمال
یک بار فشار دادن «بررسی کنید» چه چیزی را بررسی میکند، «امتحان کنید» برای یک اسکریپت چه میکند، و «اعمال» چه میسازد.
مرجع
- اسناد انکشافدهندگان Lingara
API lingara.v1 که اسکریپت یک مرحله فراخوانی میکند، کارهایی که اسکریپت اجازه دارد انجام دهد، و این تعهد که v1 فقط بزرگتر میشود.