کتابخانههای 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.
استفاده از کتابخانهها
- تصدیق هویت
هر کتابخانه چطور شناسه و رمز کلاینت شما را به توکنهای دسترسی تبدیل میکند و آنها را تازه نگه میدارد.
- جریانها
کتابخانهها نتایج جریانی را چطور تحویل میدهند، و یک جریان چه وقت ختم یا ناکام میشود.
- خطاها و تلاش دوباره
چهار خطایی که هر کتابخانه برمیگرداند، و ناکامیهایی که از طرف شما دوباره امتحان میکند.