Lingara Lingara مستندات رهنماها API کتابخانه‌ها اپلیکیشن‌ها ساختن اپلیکیشن وب
زبان: دری

کتابخانه‌های Lingara API

این صفحه از انگلیسی ترجمه شده است. اگر این دو با هم فرق داشته باشند، صفحهٔ انگلیسی درست است. صفحهٔ انگلیسی را بخوانید

کتابخانه‌های Lingara API همان API را صدا می‌زنند که مرجع شرح می‌دهد، به زبانی که از قبل با آن کد می‌نویسید. همه از یک مشخصات واحد تولید شده‌اند و قرارداد یکسان دارند، پس هر چه در یکی یاد بگیرید در دیگران هم به کار می‌آید:

  • تصدیق هویت. شناسه کلاینت و رمز آن را یک بار به کلاینت می‌دهید. کلاینت آن‌ها را با یک توکن دسترسی تبادله می‌کند، آن را در حافظه موقت نگه می‌دارد، کمی پیش از ختم اعتبار تازه‌اش می‌سازد، و اگر API با 401 جواب بدهد، فراخوانی را یک بار با توکن تازه تکرار می‌کند.
  • جریان‌ها. عملیاتی که نتایج را به شکل جریانی می‌فرستند، مانند تولید لغات، به شکل نوع تکرارکننده خود همان زبان می‌رسند. کتابخانه رویدادها را تجزیه می‌کند و با ختم جریان، تکرار را تمام می‌کند.
  • خطاها. هر ناکامی یکی از چهار خطایی است که نوع پایه مشترک دارند، پس یک رسیدگی‌کننده می‌تواند همه را بگیرد.
  • تلاش دوباره. جواب 429 یا 503 که مدت انتظار را بگوید، تا یک حد معین از طرف شما دوباره امتحان می‌شود. هر چیز دیگر فوراً برگردانده می‌شود.

هر نمونه کد در این صفحه‌ها از یک نسخه نشرشده کتابخانه‌ها گرفته شده است، که پیش از نشر در آن کمپایل و تست می‌شود.

نصب

زبان خود را از لست پایین انتخاب کنید. هر زبان صفحه جداگانه با یک اولین فراخوانی دارد، و صفحه‌های بخش استفاده از کتابخانه‌ها هر رفتار را با جزئیات بیشتر توضیح می‌دهند.

TypeScript

npm install @lingara/api@0.1.0-alpha.6

Rust

cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-thread

Go

go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6

Java

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

Kotlin

implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")

Ruby

gem install lingara -v 0.1.0-alpha.6

PHP

composer require spinningcatstudios/lingara:0.1.0-alpha.6

زبان‌ها

  • TypeScript

    کتابخانه Lingara API برای Node.js، نشرشده در npm.

  • Rust

    کتابخانه Lingara API برای Rust غیرهمزمان، نشرشده در crates.io.

  • Go

    کتابخانه Lingara API برای Go، ماژولی بدون هیچ وابستگی بیرون از کتابخانه معیاری.

  • Java

    کتابخانه Lingara API برای Java 17 و بالاتر، نشرشده در Maven Central.

  • Kotlin

    کتابخانه Lingara API برای Kotlin روی JVM، ساخته‌شده بر پایه کوروتین‌ها.

  • Ruby

    کتابخانه Lingara API برای Ruby، یک gem بدون هیچ وابستگی وقت اجرا.

  • PHP

    کتابخانه Lingara API برای PHP 8.2 و بالاتر، نشرشده در Packagist.

استفاده از کتابخانه‌ها

  • تصدیق هویت

    هر کتابخانه چطور شناسه و رمز کلاینت شما را به توکن‌های دسترسی تبدیل می‌کند و آن‌ها را تازه نگه می‌دارد.

  • جریان‌ها

    کتابخانه‌ها نتایج جریانی را چطور تحویل می‌دهند، و یک جریان چه وقت ختم یا ناکام می‌شود.

  • خطاها و تلاش دوباره

    چهار خطایی که هر کتابخانه برمی‌گرداند، و ناکامی‌هایی که از طرف شما دوباره امتحان می‌کند.