Lingara API 函式庫

本頁譯自英文。如兩者有出入，以英文頁面為準。閱讀英文頁面

Lingara API 函式庫呼叫的正是參考文件所描述的那個 API，用的是你已經在寫的語言。每個函式庫都由同一份規格產生，遵守同一套約定，所以你在一個函式庫學到的東西可以直接套用到其他函式庫：

身分驗證。 你只需把用戶端 ID 和密鑰交給用戶端一次。它會用它們換取存取權杖、快取權杖、在權杖到期前不久更新它，並在 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 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