Lingara Lingara Dokumentasi Panduan API Pustaka Aplikasi Bina Apl web
Bahasa: Bahasa Melayu

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.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

Bahasa

  • 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.