Lingara API-bibliotheken
Deze pagina is vertaald uit het Engels. Als de twee verschillen, is de Engelse pagina juist. Lees de Engelse pagina
De Lingara API-bibliotheken roepen dezelfde API aan die de referentie beschrijft, in de taal die je al schrijft. Elke bibliotheek wordt gegenereerd uit dezelfde specificatie en houdt zich aan hetzelfde contract, dus wat je in de ene leert, neem je mee naar de andere:
- Authenticatie. Je geeft de client één keer je client-ID en secret. Hij ruilt die in voor een access token, bewaart het in een cache, vernieuwt het kort voordat het verloopt en herhaalt een aanroep één keer met een vers token als de API 401 antwoordt.
- Streams. Bewerkingen die streamen, zoals het genereren van woordenschat, komen binnen als het eigen soort iterator van de taal. De bibliotheek parseert de events en beëindigt de iteratie wanneer de stream klaar is.
- Fouten. Elke fout is een van vier fouten met een gedeeld basistype, zodat één handler ze allemaal kan opvangen.
- Herhaalpogingen. Een 429 of 503 die aangeeft hoe lang je moet wachten, wordt tot een limiet automatisch opnieuw geprobeerd. Al het andere wordt meteen opgeworpen.
Elk codevoorbeeld op deze pagina’s komt uit een uitgebrachte versie van de bibliotheken, waar het wordt gecompileerd en getest voordat het uitkomt.
Installeren
Kies hieronder je taal. Elke taal heeft een eigen pagina met een eerste aanroep, en de pagina’s onder De bibliotheken gebruiken leggen elk gedrag uitgebreider uit.
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.6Talen
- TypeScript
De Lingara API-bibliotheek voor Node.js, gepubliceerd op npm.
- Rust
De Lingara API-bibliotheek voor async Rust, gepubliceerd op crates.io.
- Go
De Lingara API-bibliotheek voor Go, een module zonder afhankelijkheden buiten de standaardbibliotheek.
- Java
De Lingara API-bibliotheek voor Java 17 en hoger, gepubliceerd op Maven Central.
- Kotlin
De Lingara API-bibliotheek voor Kotlin op de JVM, gebouwd op coroutines.
- Ruby
De Lingara API-bibliotheek voor Ruby, een gem zonder runtime-afhankelijkheden.
- PHP
De Lingara API-bibliotheek voor PHP 8.2 en hoger, gepubliceerd op Packagist.
De bibliotheken gebruiken
- Authenticatie
Hoe elke bibliotheek je client-ID en secret omzet in access tokens en die vers houdt.
- Streams
Hoe de bibliotheken gestreamde resultaten leveren, en wanneer een stream eindigt of mislukt.
- Fouten en herhaalpogingen
De vier fouten die elke bibliotheek opwerpt, en welke mislukkingen ze automatisch opnieuw probeert.