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.6Rust
cargo add lingara@0.1.0-alpha.6
cargo add tokio --features macros,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_api_clients/go@v0.1.0-alpha.6Java
<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.6PHP
composer require spinningcatstudios/lingara:0.1.0-alpha.6Kielet
- 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.