Bắt đầu nhanh

Phiên bản API 2026-10-affable-towhee

Năm bước để đi từ con số không đến một danh sách từ vựng được truyền phát: tạo ứng dụng khách, đưa nó vào shell, đổi nó lấy token truy cập, thực hiện một lệnh gọi, và lấy token mới khi token hết hạn.

1. Tạo ứng dụng khách

Trên trang Tích hợp của ứng dụng web Lingara, tại app.getlingara.com/admin, trong mục Ứng dụng khách OAuth, hãy tạo một ứng dụng khách có thể Tạo từ vựng (phạm vi vocab:generate). Sao chép ID ứng dụng khách và khóa bí mật của nó. Khóa bí mật chỉ hiển thị một lần.

2. Đưa vào shell

Lưu ID ứng dụng khách và khóa bí mật vào các biến môi trường LINGARA_CLIENT_ID và LINGARA_CLIENT_SECRET, để không bao giờ phải viết khóa bí mật vào lệnh.

export LINGARA_CLIENT_ID="<your client id>"
export LINGARA_CLIENT_SECRET="<your client secret>"

3. Lấy token truy cập

Lệnh này đổi ứng dụng khách lấy một token truy cập và giữ nó trong LINGARA_TOKEN, nơi mọi ví dụ trong tài liệu tham chiếu này đọc token. Lệnh cần jq và curl 7.76 trở lên. Nếu lần đổi thất bại, lệnh in ra mã lỗi (ví dụ invalid_client: hãy kiểm tra ID và khóa bí mật) và để trống LINGARA_TOKEN, nên lệnh gọi tiếp theo thất bại với 401 cho đến khi đổi thành công. Nếu không có jq, hãy chạy lần đổi trong hướng dẫn Xác thực và sao chép access_token từ phản hồi bằng tay.

export LINGARA_TOKEN="$(curl -sS --fail-with-body -X POST "https://api.getlingara.com/oauth/token" \
  -u "$LINGARA_CLIENT_ID:$LINGARA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  --data-urlencode "scope=vocab:generate" | jq -r '.access_token // error(.error)')"

4. Tạo danh sách từ vựng

Chạy lệnh này. -N tắt bộ đệm của curl, nên mỗi sự kiện được in ra ngay khi đến.

curl -N -X POST "https://api.getlingara.com/v1/vocab/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"level":2,"source_lang":"en","target_lang":"zh","count":8}'

Kết quả bạn sẽ thấy

Một sự kiện started kèm thông tin chi tiết của danh sách, một sự kiện item cho mỗi từ, rồi done. Các từ của bạn sẽ khác với ví dụ này.

event: started
data: {"meta":{"level":2,"source_lang":"en","target_lang":"zh","framework":"HSK","count":2,"ai_generated":true}}

event: item
data: {"word":"你好","pronunciation":"nǐ hǎo","translation":"hello","example":{"sentence":"你好，我叫小明。","translation":"Hello, my name is Xiaoming."}}

event: item
data: {"word":"谢谢","pronunciation":"xiè xie","translation":"thank you"}

event: done
data: {}

5. Khi hết một giờ

Lệnh gọi trả lời 401. Hãy chạy lại bước 3. Nếu bước 3 giờ thất bại, thì ứng dụng khách hoặc khóa bí mật của nó đã thay đổi trên trang Tích hợp. Một chương trình tuân theo quy tắc của hướng dẫn Xác thực: đổi lại một lần cho mỗi 401, và dừng lại nếu lần đổi thất bại.

Nếu bản dịch và tài liệu tham chiếu tiếng Anh khác nhau, tài liệu tham chiếu tiếng Anh là bản đúng.