Lingara Lingara 說明文件 學習指南 API 函式庫 應用程式 起造 網頁版
語言: 閩南語

Lingara API 函式庫

這頁是對英文翻譯過來的。若兩篇無仝,以英文頁為準。 看英文頁

Lingara API 函式庫呼叫的就是參考文件講的彼个 API,用的是你本底就咧寫的語言。逐个函式庫攏是對仝一份規格產生的,守仝一套約定,所以你佇一个內底學著的,會當直接提去其他的用:

  • 身分驗證。 你干焦需要共用戶端 ID 佮密鑰交予用戶端一擺。伊會用這寡換存取權杖、快取權杖、佇到期進前一屑仔更新伊,若 API 回應 401,就會用新權杖共呼叫重試一擺。
  • 串流。 用串流回傳的操作(像產生詞彙),會用彼種語言家己的迭代器形式送到。函式庫會解析事件,串流結束的時陣就會停止迭代。
  • 錯誤。 逐个失敗攏是四種錯誤之一,in 共用仝一个基底型別,所以一个處理程式就會當攏總掠起來。
  • 重試。 講明愛等偌久的 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

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

程式語言

  • 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 發布。

使用函式庫

  • 身分驗證

    逐个函式庫按怎共你的用戶端 ID 佮密鑰換做存取權杖,閣按怎予權杖一直保持有效。

  • 串流

    函式庫按怎交付串流結果,閣有串流啥物時陣會結束抑是失敗。

  • 錯誤佮重試

    逐个函式庫攏會擲出的四種錯誤,閣有伊會替你重試佗一寡失敗。