Librerie dell'API Lingara

Questa pagina è tradotta dall'inglese. Se le due versioni differiscono, fa fede la pagina in inglese. Leggi la pagina in inglese

Le librerie dell’API Lingara chiamano la stessa API descritta nel riferimento, nel linguaggio che scrivi già. Ognuna è generata dalla stessa specifica e rispetta lo stesso contratto, quindi ciò che impari con una vale anche per le altre:

• Autenticazione. Fornisci al client il tuo ID client e il tuo secret una sola volta. Il client li scambia con un token di accesso, lo mette in cache, lo rinnova poco prima che scada e ripete una chiamata una volta con un token nuovo se l’API risponde 401.
• Stream. Le operazioni che trasmettono in streaming, come la generazione di vocabolario, arrivano sotto forma dell’iteratore tipico del linguaggio. La libreria analizza gli eventi e termina l’iterazione quando lo stream finisce.
• Errori. Ogni fallimento è uno di quattro errori con un tipo base comune, quindi un solo gestore può intercettarli tutti.
• Nuovi tentativi. Un 429 o 503 che indica quanto attendere viene ritentato per te, fino a un limite. Tutto il resto viene sollevato subito.

Ogni esempio di codice in queste pagine proviene da una versione pubblicata delle librerie, dove viene compilato e testato prima del rilascio.

Installazione

Scegli il tuo linguaggio qui sotto. Ogni linguaggio ha una propria pagina con una prima chiamata, e le pagine della sezione Usare le librerie spiegano ogni comportamento più nel dettaglio.

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