Pustaka API Lingara
Halaman ini diterjemahkan dari bahasa Inggris. Jika keduanya berbeda, halaman bahasa Inggris yang benar. Baca halaman bahasa Inggris
Pustaka API Lingara memanggil API yang sama dengan yang dijelaskan referensi, dalam bahasa yang sudah Anda gunakan. Setiap pustaka dihasilkan dari spesifikasi yang sama dan memegang kontrak yang sama, jadi apa yang Anda pelajari di satu pustaka juga berlaku di pustaka lainnya:
- Autentikasi. Anda memberikan ID klien dan secret Anda kepada klien satu kali saja. Klien menukarnya dengan token akses, menyimpannya di cache, memperbaruinya sesaat sebelum kedaluwarsa, dan mengulang panggilan satu kali dengan token baru jika API menjawab 401.
- Stream. Operasi yang melakukan streaming, seperti membuat kosakata, datang sebagai jenis iterator milik bahasa itu sendiri. Pustaka mengurai event-nya dan mengakhiri iterasi saat stream selesai.
- Error. Setiap kegagalan adalah salah satu dari empat error dengan tipe dasar yang sama, sehingga satu handler dapat menangkap semuanya.
- Percobaan ulang. 429 atau 503 yang menyebutkan berapa lama harus menunggu akan diulang untuk Anda, hingga batas tertentu. Kegagalan lain langsung dilempar.
Setiap contoh kode di halaman-halaman ini berasal dari versi pustaka yang sudah dirilis, tempat kode itu dikompilasi dan diuji sebelum dikirim.
Pemasangan
Pilih bahasa Anda di bawah. Setiap bahasa punya halamannya sendiri dengan panggilan pertama, dan halaman di bawah Menggunakan pustaka menjelaskan setiap perilaku secara lebih rinci.
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 dependensi di luar pustaka standar.
- Java
Pustaka API Lingara untuk Java 17 dan yang lebih baru, diterbitkan di Maven Central.
- Kotlin
Pustaka API Lingara untuk Kotlin di JVM, dibangun di atas coroutine.
- Ruby
Pustaka API Lingara untuk Ruby, sebuah gem tanpa dependensi runtime.
- PHP
Pustaka API Lingara untuk PHP 8.2 dan yang lebih baru, diterbitkan di Packagist.
Menggunakan pustaka
- Autentikasi
Cara setiap pustaka mengubah ID klien dan secret Anda menjadi token akses, dan menjaganya tetap segar.
- Stream
Cara pustaka mengirimkan hasil yang di-stream, dan kapan sebuah stream berakhir atau gagal.
- Error dan percobaan ulang
Empat error yang dilempar setiap pustaka, dan kegagalan mana yang diulang untuk Anda.