Pustaka API Lingara
Halaman ini diterjemahkan daripada bahasa Inggeris. Jika kedua-duanya berbeza, halaman bahasa Inggeris adalah yang betul. Baca halaman bahasa Inggeris
Pustaka API Lingara memanggil API yang sama seperti yang diterangkan dalam rujukan, dalam bahasa yang sudah anda gunakan. Setiap pustaka dijana daripada spesifikasi yang sama dan mengekalkan kontrak yang sama, jadi apa yang anda pelajari dalam satu pustaka terpakai juga pada yang lain:
- Pengesahan. Anda memberikan ID klien dan rahsia anda kepada klien sekali sahaja. Klien menukarnya dengan token akses, menyimpannya dalam cache, memperbaharuinya sejurus sebelum ia tamat tempoh, dan mencuba semula panggilan sekali dengan token baharu jika API menjawab 401.
- Strim. Operasi yang menstrim, seperti menjana perbendaharaan kata, tiba sebagai jenis iterator bahasa itu sendiri. Pustaka menghurai peristiwanya dan menamatkan lelaran apabila strim selesai.
- Ralat. Setiap kegagalan ialah salah satu daripada empat ralat yang berkongsi jenis asas, jadi satu pengendali boleh menangkap kesemuanya.
- Cubaan semula. 429 atau 503 yang menyatakan berapa lama perlu menunggu akan dicuba semula untuk anda, sehingga had tertentu. Kegagalan lain dilontarkan serta-merta.
Setiap contoh kod di halaman ini datang daripada versi pustaka yang telah dikeluarkan, di mana ia dikompil dan diuji sebelum dihantar.
Pemasangan
Pilih bahasa anda di bawah. Setiap bahasa mempunyai halamannya sendiri dengan panggilan pertama, dan halaman di bawah Menggunakan pustaka menerangkan setiap tingkah laku dengan lebih terperinci.
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.6Bahasa
- TypeScript
Pustaka API Lingara untuk Node.js, diterbitkan di npm.
- Rust
Pustaka API Lingara untuk Rust async, diterbitkan di crates.io.
- Go
Pustaka API Lingara untuk Go, sebuah modul tanpa kebergantungan di luar pustaka standard.
- Java
Pustaka API Lingara untuk Java 17 dan lebih baharu, diterbitkan di Maven Central.
- Kotlin
Pustaka API Lingara untuk Kotlin pada JVM, dibina di atas coroutine.
- Ruby
Pustaka API Lingara untuk Ruby, sebuah gem tanpa kebergantungan masa jalan.
- PHP
Pustaka API Lingara untuk PHP 8.2 dan lebih baharu, diterbitkan di Packagist.
Menggunakan pustaka
- Pengesahan
Cara setiap pustaka menukar ID klien dan rahsia anda menjadi token akses, dan memastikannya sentiasa segar.
- Strim
Cara pustaka menghantar hasil yang distrim, dan bila sesuatu strim tamat atau gagal.
- Ralat dan cubaan semula
Empat ralat yang dilontarkan oleh setiap pustaka, dan kegagalan mana yang dicuba semula untuk anda.