الوصفات

هذه الصفحة مترجمة من الإنجليزية. إذا اختلفت النسختان، فالصفحة الإنجليزية هي الصحيحة. اقرأ الصفحة الإنجليزية

الوصفة اتصال يحمل اسم ما تريد فعله. تختار واحدة في التطبيقات والاتصالات، تحت «إنشاء اتصال»، بعد الضغط على «ابدأ الإنشاء». ثم يعرض المعالج خطواتها واحدة تلو الأخرى، وتُحفظ كل خطوة أثناء تنقّلك، فيمكنك المغادرة والعودة. الوصفة التي لا يعرضها لك التطبيق غير متاحة في حسابك بعد.

تنتهي كل وصفة بالخطوتين نفسيهما، «التحقق» و«تطبيق». يصفهما الاختبار والتشغيل التجريبي والتطبيق.

السماح لخادمي باستدعاء Lingara

يحصل خادمك على تسجيل دخول وكلمة مرور خاصين به، ليتمكن من استخدام Lingara نيابةً عنك.

• تُنشئ: تسجيل دخول لخادمك (عميل OAuth)، وكلمة مرور لتسجيل الدخول هذا (سر العميل).
• الخطوات: «الاسم والقدرات»، «التحقق»، «تطبيق».
• بعد ذلك: يسجّل خادمك الدخول بتسجيل الدخول هذا وكلمة المرور الخاصة به، ثم يستدعي Lingara بالقدرات التي منحته إياها في «ما المسموح له بفعله».

نص برمجي اختياري لخطوة تسجيل الدخول، يحتفظ بالاسم الذي كتبته ويَسِمه بأنه لخادمك:

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

إبلاغ خادمي عندما تجهز خطة درس

ترسل Lingara إلى خادمك رسالة في كل مرة تجهز فيها إحدى خطط دروسك.

• تُنشئ: تسجيل دخول لخادمك، وكلمة مرور لتسجيل الدخول هذا، ورسائل إلى خادمك (نقطة نهاية webhook).
• الخطوات: «الاسم والقدرات»، «إلى أين نرسله»، «التحقق»، «تطبيق».
• بعد ذلك: يستقبل خادمك 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'] }) })