Bibliotecas de la API de Lingara

Esta página está traducida del inglés. Si ambas difieren, la página en inglés es la correcta. Leer la página en inglés

Las bibliotecas de la API de Lingara llaman a la misma API que describe la referencia, en el lenguaje que ya escribes. Cada una se genera a partir de la misma especificación y mantiene el mismo contrato, así que lo que aprendas en una te sirve en las demás:

• Autenticación. Le das al cliente tu ID de cliente y tu secreto una sola vez. Los intercambia por un token de acceso, lo guarda en caché, lo renueva poco antes de que caduque y reintenta una llamada una vez con un token nuevo si la API responde 401.
• Flujos. Las operaciones que emiten un flujo, como generar vocabulario, llegan como el tipo de iterador propio del lenguaje. La biblioteca analiza los eventos y termina la iteración cuando el flujo acaba.
• Errores. Todo fallo es uno de cuatro errores con un tipo base común, así que un solo manejador puede capturarlos todos.
• Reintentos. Un 429 o 503 que indica cuánto esperar se reintenta por ti, hasta un límite. Todo lo demás se lanza de inmediato.

Cada ejemplo de código de estas páginas procede de una versión publicada de las bibliotecas, donde se compila y se prueba antes de publicarse.

Instalación

Elige tu lenguaje a continuación. Cada lenguaje tiene su propia página con una primera llamada, y las páginas de Uso de las bibliotecas explican cada comportamiento con más detalle.

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