Lingara Lingara Dokumentation Ratgeber API Bibliotheken Apps Erstellen Web-App
Sprache: Deutsch

Lingara-API-Bibliotheken

Diese Seite ist aus dem Englischen übersetzt. Wenn die beiden voneinander abweichen, ist die englische Seite maßgeblich. Englische Seite lesen

Die Lingara-API-Bibliotheken rufen dieselbe API auf, die die Referenz beschreibt – in der Sprache, in der Sie ohnehin schreiben. Jede wird aus derselben Spezifikation generiert und hält denselben Vertrag ein, sodass sich das, was Sie bei einer lernen, auf die anderen übertragen lässt:

  • Authentifizierung. Sie übergeben dem Client Ihre Client-ID und Ihr Secret einmal. Er tauscht sie gegen ein Zugriffstoken, speichert es im Cache, erneuert es kurz vor Ablauf und wiederholt einen Aufruf einmal mit einem frischen Token, wenn die API mit 401 antwortet.
  • Streams. Operationen, die streamen, etwa das Generieren von Vokabeln, kommen als die sprachtypische Art von Iterator an. Die Bibliothek parst die Events und beendet die Iteration, wenn der Stream endet.
  • Fehler. Jeder Fehlschlag ist einer von vier Fehlern mit einem gemeinsamen Basistyp, sodass ein einziger Handler alle abfangen kann.
  • Wiederholungen. Ein 429 oder 503, der angibt, wie lange zu warten ist, wird bis zu einer Obergrenze automatisch für Sie wiederholt. Alles andere wird sofort ausgelöst.

Jedes Codebeispiel auf diesen Seiten stammt aus einer veröffentlichten Version der Bibliotheken, in der es vor der Auslieferung kompiliert und getestet wird.

Installation

Wählen Sie unten Ihre Sprache. Jede Sprache hat eine eigene Seite mit einem ersten Aufruf, und die Seiten unter Die Bibliotheken verwenden erklären jedes Verhalten im Detail.

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

Sprachen

  • TypeScript

    Die Lingara-API-Bibliothek für Node.js, veröffentlicht auf npm.

  • Rust

    Die Lingara-API-Bibliothek für asynchrones Rust, veröffentlicht auf crates.io.

  • Go

    Die Lingara-API-Bibliothek für Go, ein Modul ohne Abhängigkeiten außerhalb der Standardbibliothek.

  • Java

    Die Lingara-API-Bibliothek für Java 17 und neuer, veröffentlicht auf Maven Central.

  • Kotlin

    Die Lingara-API-Bibliothek für Kotlin auf der JVM, aufgebaut auf Coroutinen.

  • Ruby

    Die Lingara-API-Bibliothek für Ruby, ein Gem ohne Laufzeitabhängigkeiten.

  • PHP

    Die Lingara-API-Bibliothek für PHP 8.2 und neuer, veröffentlicht auf Packagist.

Die Bibliotheken verwenden

  • Authentifizierung

    Wie jede Bibliothek Ihre Client-ID und Ihr Secret in Zugriffstokens umwandelt und diese aktuell hält.

  • Streams

    Wie die Bibliotheken gestreamte Ergebnisse liefern und wann ein Stream endet oder fehlschlägt.

  • Fehler und Wiederholungen

    Die vier Fehler, die jede Bibliothek auslöst, und welche Fehlschläge sie für Sie wiederholt.