Lingara Lingara Tài liệu Cẩm nang API Thư viện Ứng dụng Tạo Ứng dụng web
Ngôn ngữ: Tiếng Việt

Thư viện Lingara API

Trang này được dịch từ tiếng Anh. Nếu hai bản khác nhau, trang tiếng Anh là bản đúng. Đọc trang tiếng Anh

Các thư viện API Lingara gọi đúng API mà tài liệu tham chiếu mô tả, bằng chính ngôn ngữ bạn đang viết. Mỗi thư viện đều được sinh ra từ cùng một đặc tả và giữ cùng một hợp đồng, nên những gì bạn học ở một thư viện cũng áp dụng được cho các thư viện khác:

  • Xác thực. Bạn chỉ cần đưa ID máy khách và khóa bí mật cho máy khách một lần. Máy khách đổi chúng lấy mã truy cập, lưu mã vào bộ nhớ đệm, làm mới mã ngay trước khi hết hạn, và thử lại một lệnh gọi một lần với mã mới nếu API trả về 401.
  • Luồng. Các thao tác phát trực tuyến, chẳng hạn như tạo từ vựng, được trả về dưới dạng trình lặp riêng của từng ngôn ngữ. Thư viện phân tích các sự kiện và kết thúc vòng lặp khi luồng kết thúc.
  • Lỗi. Mọi lỗi đều thuộc một trong bốn loại lỗi có chung một kiểu cơ sở, nên chỉ một trình xử lý là bắt được tất cả.
  • Thử lại. Phản hồi 429 hoặc 503 có cho biết cần chờ bao lâu sẽ được tự động thử lại, trong một giới hạn nhất định. Mọi trường hợp khác đều được ném ra ngay lập tức.

Mọi mẫu mã trên các trang này đều lấy từ một phiên bản đã phát hành của thư viện, nơi mã được biên dịch và kiểm thử trước khi phát hành.

Cài đặt

Hãy chọn ngôn ngữ của bạn bên dưới. Mỗi ngôn ngữ có trang riêng với một lệnh gọi đầu tiên, và các trang trong mục Sử dụng thư viện giải thích chi tiết hơn từng hành vi.

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

Ngôn ngữ

  • TypeScript

    Thư viện API Lingara cho Node.js, được phát hành trên npm.

  • Rust

    Thư viện API Lingara cho Rust bất đồng bộ, được phát hành trên crates.io.

  • Go

    Thư viện API Lingara cho Go, một mô-đun không có phụ thuộc nào ngoài thư viện chuẩn.

  • Java

    Thư viện API Lingara cho Java 17 trở lên, được phát hành trên Maven Central.

  • Kotlin

    Thư viện API Lingara cho Kotlin trên JVM, được xây dựng trên coroutine.

  • Ruby

    Thư viện API Lingara cho Ruby, một gem không có phụ thuộc lúc chạy.

  • PHP

    Thư viện API Lingara cho PHP 8.2 trở lên, được phát hành trên Packagist.

Dùng các thư viện

  • Xác thực

    Cách mọi thư viện biến ID máy khách và khóa bí mật của bạn thành mã truy cập, và giữ cho chúng luôn còn hiệu lực.

  • Luồng

    Cách các thư viện trả về kết quả dạng luồng, và khi nào một luồng kết thúc hoặc thất bại.

  • Lỗi và thử lại

    Bốn loại lỗi mà mọi thư viện ném ra, và những lỗi nào thư viện tự động thử lại cho bạn.