Lingara API libraries

The Lingara API libraries call the same API the reference describes, in the language you already write. Each one is generated from the same specification and keeps the same contract, so what you learn in one carries over to the others:

• Authentication. You give the client your client ID and secret once. It exchanges them for an access token, caches it, refreshes it shortly before it expires, and retries a call once with a fresh token if the API answers 401.
• Streams. Operations that stream, such as generating vocabulary, arrive as the language’s own kind of iterator. The library parses the events and ends the iteration when the stream finishes.
• Errors. Every failure is one of four errors with a shared base type, so one handler can catch them all.
• Retries. A 429 or 503 that says how long to wait is retried for you, up to a limit. Anything else is raised straight away.

Every code sample on these pages comes from a released version of the libraries, where it is compiled and tested before it ships.

Install

Pick your language below. Each language has its own page with a first call, and the pages under Using the libraries explain each behaviour in more detail.

npm install @lingara/api@0.1.0-alpha.6

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

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")

gem install lingara -v 0.1.0-alpha.6

composer require spinningcatstudios/lingara:0.1.0-alpha.6