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.6Rust
cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Java
<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.6PHP
composer require spinningcatstudios/lingara:0.1.0-alpha.6Sprachen
- 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.