Bibliothèques de l'API Lingara

Cette page est traduite de l'anglais. En cas de différence, la page anglaise fait foi. Lire la page en anglais

Les bibliothèques de l’API Lingara appellent la même API que celle décrite dans la référence, dans le langage que vous écrivez déjà. Chacune est générée à partir de la même spécification et respecte le même contrat, si bien que ce que vous apprenez avec l’une vaut aussi pour les autres :

• Authentification. Vous donnez une seule fois au client votre identifiant client et votre secret. Il les échange contre un jeton d’accès, le met en cache, le renouvelle peu avant son expiration et relance une fois un appel avec un nouveau jeton si l’API répond 401.
• Flux. Les opérations qui diffusent un flux, comme la génération de vocabulaire, arrivent sous la forme de l’itérateur propre au langage. La bibliothèque analyse les événements et termine l’itération quand le flux se termine.
• Erreurs. Tout échec est l’une de quatre erreurs partageant un type de base commun, de sorte qu’un seul gestionnaire peut toutes les intercepter.
• Nouvelles tentatives. Une réponse 429 ou 503 qui indique combien de temps attendre est retentée pour vous, jusqu’à une certaine limite. Tout le reste est levé immédiatement.

Chaque exemple de code de ces pages provient d’une version publiée des bibliothèques, où il est compilé et testé avant sa sortie.

Installation

Choisissez votre langage ci-dessous. Chaque langage a sa propre page avec un premier appel, et les pages de la rubrique Utiliser les bibliothèques expliquent chaque comportement plus en détail.

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