البدء مع 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 للمطوّرين كل ما يمكن للنص البرمجي استدعاؤه.
• كل ما يُنشئه الاتصال يمكنك أيضًا إنشاؤه بيدك في أدوات المطوّرين، في تطبيق الويب.