Lingara API 函式庫
這頁是對英文翻譯過來的。若兩篇無仝,以英文頁為準。 看英文頁
Lingara API 函式庫呼叫的就是參考文件講的彼个 API,用的是你本底就咧寫的語言。逐个函式庫攏是對仝一份規格產生的,守仝一套約定,所以你佇一个內底學著的,會當直接提去其他的用:
- 身分驗證。 你干焦需要共用戶端 ID 佮密鑰交予用戶端一擺。伊會用這寡換存取權杖、快取權杖、佇到期進前一屑仔更新伊,若 API 回應 401,就會用新權杖共呼叫重試一擺。
- 串流。 用串流回傳的操作(像產生詞彙),會用彼種語言家己的迭代器形式送到。函式庫會解析事件,串流結束的時陣就會停止迭代。
- 錯誤。 逐个失敗攏是四種錯誤之一,in 共用仝一个基底型別,所以一个處理程式就會當攏總掠起來。
- 重試。 講明愛等偌久的 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
予 Node.js 用的 Lingara API 函式庫,佇 npm 發布。
- Rust
予非同步 Rust 用的 Lingara API 函式庫,佇 crates.io 發布。
- Go
予 Go 用的 Lingara API 函式庫,一个除了標準函式庫以外無任何相依套件的模組。
- Java
予 Java 17 抑是較新版本用的 Lingara API 函式庫,佇 Maven Central 發布。
- Kotlin
佇 JVM 頂面行、用協程做的 Kotlin 版 Lingara API 函式庫。
- Ruby
予 Ruby 用的 Lingara API 函式庫,一个無任何執行期相依套件的 gem。
- PHP
予 PHP 8.2 抑是較新版本用的 Lingara API 函式庫,佇 Packagist 發布。