Lingara API ライブラリ

このページは英語から翻訳されています。内容に相違がある場合は、英語のページが正しい内容です。英語のページを読む

Lingara API ライブラリは、リファレンスで説明されているのと同じ API を、普段お使いの言語から呼び出します。どのライブラリも同じ仕様から生成され、同じ契約を守っているため、1 つで覚えたことはほかのライブラリにもそのまま通用します。

認証。 クライアント ID とシークレットをクライアントに一度渡すだけです。クライアントはそれをアクセストークンと交換してキャッシュし、有効期限の少し前に更新し、API が 401 を返した場合は新しいトークンで呼び出しを 1 回だけ再試行します。
ストリーム。 語彙の生成など、ストリーミングする操作の結果は、その言語固有のイテレーターとして届きます。ライブラリがイベントを解析し、ストリームが終わるとイテレーションを終了します。
エラー。 すべての失敗は、共通の基底型を持つ 4 種類のエラーのいずれかなので、1 つのハンドラーですべて捕捉できます。
再試行。 待機時間を示す 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