Lingara Lingara Documentatie Gidsen API Bibliotheken Apps Bouwen Webapp
Taal: Nederlands

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.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

Talen

  • 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.