Mga library ng Lingara API
Isinalin mula sa Ingles ang pahinang ito. Kung magkaiba ang dalawa, ang pahinang Ingles ang tama. Basahin ang pahinang Ingles
Tinatawag ng mga library ng Lingara API ang parehong API na inilalarawan ng reference, sa wikang ginagamit mo na. Ang bawat isa ay binuo mula sa iisang specification at sumusunod sa iisang kontrata, kaya ang natutuhan mo sa isa ay magagamit mo rin sa iba:
- Pagpapatunay. Ibinibigay mo nang isang beses sa client ang iyong client ID at secret. Ipinapalit nito ang mga iyon sa isang access token, iniimbak ito sa cache, nire-refresh ito bago ito mag-expire, at inuulit nang isang beses ang tawag gamit ang bagong token kapag sumagot ang API ng 401.
- Mga stream. Ang mga operasyong nag-i-stream, gaya ng pagbuo ng bokabularyo, ay dumarating bilang sariling uri ng iterator ng wika. Pinoproseso ng library ang mga event at tinatapos ang pag-iterate kapag natapos ang stream.
- Mga error. Ang bawat pagkabigo ay isa sa apat na error na may iisang base type, kaya kayang saluhin ng iisang handler ang lahat ng ito.
- Mga retry. Ang 429 o 503 na nagsasabi kung gaano katagal maghihintay ay awtomatikong inuulit para sa iyo, hanggang sa isang limitasyon. Ang lahat ng iba pa ay agad na ibinabato.
Ang bawat halimbawang code sa mga pahinang ito ay mula sa isang inilabas na bersyon ng mga library, kung saan ito kinompile at sinubok bago ilabas.
Pag-install
Piliin ang iyong wika sa ibaba. May sariling pahina ang bawat wika na may unang tawag, at ipinapaliwanag nang mas detalyado ng mga pahina sa ilalim ng Paggamit ng mga library ang bawat gawi.
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.6Mga wika
- TypeScript
Ang library ng Lingara API para sa Node.js, na inilathala sa npm.
- Rust
Ang library ng Lingara API para sa async Rust, na inilathala sa crates.io.
- Go
Ang library ng Lingara API para sa Go, isang module na walang dependency maliban sa standard library.
- Java
Ang library ng Lingara API para sa Java 17 at mas bago, na inilathala sa Maven Central.
- Kotlin
Ang library ng Lingara API para sa Kotlin sa JVM, na binuo sa mga coroutine.
- Ruby
Ang library ng Lingara API para sa Ruby, isang gem na walang runtime dependency.
- PHP
Ang library ng Lingara API para sa PHP 8.2 at mas bago, na inilathala sa Packagist.
Paggamit ng mga library
- Pagpapatunay
Kung paano ginagawang access token ng bawat library ang iyong client ID at secret, at kung paano nito pinananatiling sariwa ang mga ito.
- Mga stream
Kung paano inihahatid ng mga library ang mga resultang naka-stream, at kung kailan natatapos o nabibigo ang isang stream.
- Mga error at retry
Ang apat na error na ibinabato ng bawat library, at kung aling mga pagkabigo ang awtomatiko nitong inuulit para sa iyo.