Mulai cepat

Versi API 2026-10-affable-towhee

Lima langkah dari nol hingga daftar kosakata yang dialirkan: buat klien, simpan di shell Anda, tukar dengan token akses, lakukan satu panggilan, dan dapatkan token baru saat token habis masa berlakunya.

1. Buat klien

Di halaman Integrasi pada aplikasi web Lingara, di app.getlingara.com/admin, di bagian Klien OAuth, buat klien yang dapat Buat kosakata (cakupan vocab:generate). Salin ID klien dan rahasianya. Rahasia hanya ditampilkan sekali.

2. Simpan di shell Anda

Simpan ID klien dan rahasia di variabel lingkungan LINGARA_CLIENT_ID dan LINGARA_CLIENT_SECRET, sehingga rahasia tidak pernah ditulis ke dalam perintah.

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

3. Dapatkan token akses

Perintah ini menukar klien dengan token akses dan menyimpannya di LINGARA_TOKEN, yang dibaca setiap contoh dalam referensi ini. Perintah ini membutuhkan jq dan curl 7.76 atau yang lebih baru. Jika penukaran gagal, perintah mencetak kode galat (misalnya invalid_client: periksa ID dan rahasia) dan membiarkan LINGARA_TOKEN kosong, sehingga panggilan berikutnya gagal dengan 401 sampai penukaran berhasil. Tanpa jq, jalankan penukaran dari panduan Autentikasi dan salin access_token dari respons secara manual.

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. Buat daftar kosakata

Jalankan perintah ini. -N mematikan buffering curl, sehingga setiap peristiwa dicetak begitu tiba.

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}'

Yang seharusnya Anda lihat

Satu peristiwa started dengan detail daftar, satu peristiwa item per kata, lalu done. Kata-kata Anda akan berbeda dari contoh ini.

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. Saat satu jam berlalu

Panggilan menjawab 401. Jalankan langkah 3 lagi. Jika langkah 3 kini gagal, klien atau rahasianya telah berubah di halaman Integrasi. Program mengikuti aturan panduan Autentikasi: tukar ulang sekali per 401, dan berhenti jika penukaran gagal.

Jika terjemahan berbeda dengan referensi berbahasa Inggris, referensi berbahasa Inggris yang berlaku.