Lingara Lingara 說明文件 學習指南 API 函式庫 App 建立 網頁版
語言: 客家話

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

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 摎密鑰換做存取權杖,還有仰般分權杖一直保持有效。

  • 串流

    函式庫仰般交付串流結果,還有串流麼个時節會結束抑係失敗。

  • 錯誤摎重試

    每隻函式庫都會拋出个四種錯誤,還有佢會同你重試哪兜失敗。