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.

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

  • احراز هویت

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

  • جریان‌ها

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

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

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