دەستپێکردن لەگەڵ Lingara

ئەم پەڕەیە لە ئینگلیزییەوە وەرگێڕدراوە. ئەگەر هەردووکیان جیاواز بوون، پەڕە ئینگلیزییەکە ڕاستە. پەڕە ئینگلیزییەکە بخوێنەوە

ڕاژەکار یان ئەپەکەی خۆت بە هەژماری Lingara ـەکەتەوە ببەستەوە بێ ئەوەی لە سفرەوە یەکخستنێک بنووسیت. ڕەچەتەیەک هەڵدەبژێریت، چەند خانەیەک پڕ دەکەیتەوە، ئەنجامەکە بەرامبەر یاسا ڕاستەقینەکانی Lingara دەپشکنیت، و پاشان جێبەجێی دەکەیت. سکریپتەکان ئارەزوومەندانەن.

چی دەتوانیت دروست بکەیت

پەیوەندییەک لە چوار بەشی بنیاتنان پێکدێت. هەر یەکەیان لێرەدا بە وشەکانی خودی ئەپەکە ناونراوە، و ئەو زاراوەیەی Lingara بۆی بەکاری دەهێنێت لە تەنیشتیەوەیە:

• چوونەژوورەوەیەک بۆ ڕاژەکارەکەت (کلاینتی OAuth). ڕاژەکارەکەت بەکاری دەهێنێت بۆ ئەوەی لەسەر هەژمارەکەت کار بکات.
• وشەی نهێنییەک بۆ ئەو چوونەژوورەوەیە (نهێنیی کلاینت). تەنها یەک جار دەیبینیت، ڕاستەوخۆ دوای جێبەجێکردن.
• نامەکان بۆ ڕاژەکارەکەت (خاڵی کۆتایی webhook). Lingara کاتێک شتێک ڕوودەدات، وەک ئامادەبوونی پلانێکی وانە، نامەیەک بۆ ڕاژەکارەکەت دەنێرێت.
• کارتێک لەناو Lingara (مانیفێستی ئەپ). ئەپەکەت کارتێک لەسەر پەڕەی ماڵەوە یان پلانەکانی وانەت دەکێشێت.

هەرگیز پێویست ناکات ئەمانە بە دەست پێکەوە بلکێنیت. ڕەچەتەکە بەشەکان و ڕیزبەندییەکەیان هەڵدەبژێرێت، و «بیپشکنە» پێش ئەوەی هیچ شتێک دروست بکرێت پێت دەڵێت چی دروست دەکرێت.

ئاگادارکردنەوەی ڕاژەکارەکەم کاتێک پلانێکی وانە ئامادەیە

ئەم ڕەچەتەیە چوونەژوورەوەیەک، وشەی نهێنییەکەی، و نامەکان دروست دەکات. لە ئەپی وێب دەست پێبکە، و وشەکانی خودی ڕێبەرەکە پەیڕەو بکە:

1. لە ئەپەکان و پەیوەندییەکان، لە ژێر «پەیوەندییەک دروست بکە»، «دەست بە دروستکردن بکە» دابگرە و «ئاگادارکردنەوەی ڕاژەکارەکەم کاتێک پلانێکی وانە ئامادەیە» هەڵبژێرە.
2. لە «ناو و تواناکان»، ناوێک لە چوونەژوورەوەکە بنێ.
3. لە «بۆ کوێی بنێردرێت»، ناونیشانی https:// ی ڕاژەکارەکەت بدە. هەروەها دەتوانیت «سکریپتێک بەکاربهێنە» بکەیتەوە، سکریپتەکەی خوارەوە بلکێنیت، و «تاقی بکەرەوە» داگریت.
4. لە «پشکنین»، «بیپشکنە» دابگرە و «ئەمە ئەوەیە کە دروست دەکرێت» بخوێنەوە.
5. «جێبەجێکردن» دابگرە، و هەر وشەیەکی نهێنی هەر کە دەردەکەوێت کۆپی بکە. هەر یەکەیان تەنها یەک جار نیشان دەدرێت.
6. پلانێکی وانە دروست بکە و سەیر بکە ڕاژەکارەکەت lesson_plan.ready وەردەگرێت.

سکریپتەکە ئارەزوومەندانەیە. ئەم سکریپتە هەمان کار دەکات کە خانەکان دەیکەن، و ئەو نامەیەش زیاد دەکات کە Lingara دەینێرێت کاتێک پلانێکی وانە نەتوانرا دروست بکرێت:

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

دواتر چی

• ڕەچەتەکان هەر سێ ڕەچەتەکە باس دەکات و ئەوەی چی بکەیت بەوەی هەر یەکەیان دروستی دەکات.
• تاقیکردنەوە، جێبەجێکردنی ئەزموونی و جێبەجێکردن ڕوون دەکاتەوە «بیپشکنە» چی دەپشکنێت و «جێبەجێکردن» چی دەکات.
• بەڵگەنامەکانی گەشەپێدەرانی Lingara هەموو ئەو شتانە ڕیز دەکات کە سکریپتێک دەتوانێت بانگیان بکات.
• هەموو ئەو شتانەی پەیوەندییەک دروستیان دەکات، دەتوانیت بە دەستیش لە ئامرازەکانی گەشەپێدەر، لە ئەپی وێب، دروستیان بکەیت.