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