Lingara Lingara Ohjeet Oppaat API Kirjastot Sovellukset Rakenna Verkkosovellus
Kieli: Suomi

Lingara API -kirjastot

Tämä sivu on käännetty englannista. Jos ne eroavat toisistaan, englanninkielinen sivu on oikea. Lue englanninkielinen sivu

Lingara API -kirjastot kutsuvat samaa API-rajapintaa, jonka referenssi kuvaa, sillä kielellä, jolla jo kirjoitat. Jokainen niistä generoidaan samasta määrittelystä ja noudattaa samaa sopimusta, joten se, minkä opit yhdestä, pätee myös muihin:

  • Tunnistautuminen. Annat asiakkaalle client ID:n ja salaisuuden kerran. Se vaihtaa ne käyttöoikeustunnukseen, tallentaa sen välimuistiin, uusii sen vähän ennen kuin se vanhenee ja yrittää kutsua kerran uudelleen tuoreella tunnuksella, jos API vastaa 401.
  • Virrat. Virtaavat operaatiot, kuten sanaston generointi, saapuvat kielen omana iteraattorityyppinä. Kirjasto jäsentää tapahtumat ja päättää iteroinnin, kun virta päättyy.
  • Virheet. Jokainen epäonnistuminen on yksi neljästä virheestä, joilla on yhteinen perustyyppi, joten yksi käsittelijä voi siepata ne kaikki.
  • Uudelleenyritykset. 429 tai 503, joka kertoo, kuinka kauan pitää odottaa, yritetään puolestasi uudelleen tiettyyn rajaan asti. Kaikki muu nostetaan heti.

Jokainen näiden sivujen koodiesimerkki on peräisin kirjastojen julkaistusta versiosta, jossa se käännetään ja testataan ennen julkaisua.

Asennus

Valitse kielesi alta. Jokaisella kielellä on oma sivunsa ja siinä ensimmäinen kutsu, ja sivut kohdassa Kirjastojen käyttö selittävät kunkin toiminnan tarkemmin.

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

Kielet

  • TypeScript

    Lingara API -kirjasto Node.js-ympäristöön, julkaistu npm-rekisterissä.

  • Rust

    Lingara API -kirjasto asynkroniseen Rust-koodiin, julkaistu crates.io-rekisterissä.

  • Go

    Lingara API -kirjasto Go-kielelle, moduuli ilman riippuvuuksia vakiokirjaston ulkopuolella.

  • Java

    Lingara API -kirjasto Java 17 -versiolle ja uudemmille, julkaistu Maven Central -palvelussa.

  • Kotlin

    Lingara API -kirjasto Kotlin-kielelle JVM-alustalla, rakennettu korutiinien varaan.

  • Ruby

    Lingara API -kirjasto Ruby-kielelle, gem ilman ajonaikaisia riippuvuuksia.

  • PHP

    Lingara API -kirjasto PHP 8.2 -versiolle ja uudemmille, julkaistu Packagist-palvelussa.

Kirjastojen käyttö

  • Tunnistautuminen

    Miten jokainen kirjasto muuttaa client ID:n ja salaisuuden käyttöoikeustunnuksiksi ja pitää ne tuoreina.

  • Virrat

    Miten kirjastot toimittavat virtautetut tulokset ja milloin virta päättyy tai epäonnistuu.

  • Virheet ja uudelleenyritykset

    Neljä virhettä, jotka jokainen kirjasto nostaa, ja mitkä epäonnistumiset se yrittää puolestasi uudelleen.