کتابخانههای Lingara API
این صفحه از انگلیسی ترجمه شده است. اگر این دو با هم تفاوت داشته باشند، صفحهٔ انگلیسی درست است. خواندن صفحهٔ انگلیسی
کتابخانههای Lingara API همان API را فراخوانی میکنند که مرجع توصیف میکند، به زبانی که از قبل با آن کد مینویسید. همه از یک مشخصات واحد تولید شدهاند و قرارداد یکسانی دارند، پس آنچه در یکی یاد میگیرید در بقیه هم به کار میآید:
- احراز هویت. شناسه کلاینت و رمز آن را یک بار به کلاینت میدهید. کلاینت آنها را با یک توکن دسترسی مبادله میکند، آن را در حافظه نهان نگه میدارد، کمی پیش از انقضا تازهاش میکند، و اگر API با 401 پاسخ دهد، فراخوانی را یک بار با توکنی تازه تکرار میکند.
- جریانها. عملیاتی که نتایج را بهصورت جریانی میفرستند، مانند تولید واژگان، در قالب نوع پیمایشگر خود آن زبان میرسند. کتابخانه رویدادها را تجزیه میکند و با پایان جریان، پیمایش را تمام میکند.
- خطاها. هر شکست یکی از چهار خطایی است که نوع پایه مشترکی دارند، پس یک کنترلکننده میتواند همه را بگیرد.
- تلاش دوباره. پاسخ 429 یا 503 که مدت انتظار را اعلام کند، تا سقفی معین بهجای شما دوباره امتحان میشود. هر خطای دیگری بیدرنگ برگردانده میشود.
هر نمونه کد در این صفحهها از نسخه منتشرشده کتابخانهها گرفته شده است، که پیش از انتشار در آن کامپایل و آزمایش میشود.
نصب
زبان خود را از فهرست زیر انتخاب کنید. هر زبان صفحهای جداگانه با یک فراخوانی نخست دارد، و صفحههای بخش استفاده از کتابخانهها هر رفتار را با جزئیات بیشتری توضیح میدهند.
TypeScript
npm install @lingara/api@0.1.0-alpha.6Rust
cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Java
<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.6PHP
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.
استفاده از کتابخانهها
- احراز هویت
چگونه هر کتابخانه شناسه و رمز کلاینت شما را به توکنهای دسترسی تبدیل میکند و آنها را تازه نگه میدارد.
- جریانها
کتابخانهها نتایج جریانی را چگونه تحویل میدهند، و یک جریان کی پایان مییابد یا شکست میخورد.
- خطاها و تلاش دوباره
چهار خطایی که هر کتابخانه برمیگرداند، و شکستهایی که بهجای شما دوباره امتحان میکند.