Lingara Lingara مستندات راهنماها API کتابخانه‌ها برنامه‌ها ساخت نسخهٔ وب
زبان: فارسی

شروع کار با 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 هر چیزی را که یک اسکریپت می‌تواند فراخوانی کند فهرست می‌کند.
  • هر چیزی که یک اتصال می‌سازد را می‌توانید با دست هم در ابزارهای توسعه‌دهنده، در برنامهٔ وب، بسازید.

همچنین ببینید

ساخت اتصال‌ها

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

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

  • آزمون، اجرای آزمایشی و اعمال

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

مرجع

  • مستندات توسعه‌دهندگان Lingara

    API ‏lingara.v1 که اسکریپت یک مرحله فراخوانی می‌کند، کارهایی که اسکریپت مجاز است انجام دهد، و این تعهد که v1 فقط بزرگ‌تر می‌شود.