Mula pantas

Versi API 2026-10-affable-towhee

Lima langkah daripada tiada apa-apa kepada senarai kosa kata yang distrim: cipta klien, letakkannya dalam shell anda, tukarkannya dengan token akses, buat satu panggilan, dan dapatkan token baharu apabila ia tamat tempoh.

1. Cipta klien

Pada halaman Integrasi dalam aplikasi web Lingara, di app.getlingara.com/admin, di bawah Klien OAuth, cipta klien yang boleh Jana kosa kata (skop vocab:generate). Salin ID klien dan rahsianya. Rahsia ditunjukkan sekali sahaja.

2. Letakkannya dalam shell anda

Simpan ID klien dan rahsia dalam pemboleh ubah persekitaran LINGARA_CLIENT_ID dan LINGARA_CLIENT_SECRET, supaya tiada rahsia yang pernah ditulis ke dalam arahan.

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

3. Dapatkan token akses

Arahan ini menukar klien dengan token akses dan menyimpannya dalam LINGARA_TOKEN, yang dibaca oleh setiap contoh dalam rujukan ini. Ia memerlukan jq dan curl 7.76 atau lebih baharu. Jika pertukaran gagal, arahan mencetak kod ralat (contohnya invalid_client: semak ID dan rahsia) dan membiarkan LINGARA_TOKEN kosong, jadi panggilan seterusnya gagal dengan 401 sehingga pertukaran berjaya. Tanpa jq, jalankan pertukaran daripada panduan Pengesahan dan salin access_token daripada 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. Jana senarai kosa kata

Jalankan arahan ini. -N mematikan penimbalan curl, jadi setiap peristiwa dicetak sebaik sahaja ia 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}'

Apa yang sepatutnya anda lihat

Peristiwa started dengan butiran senarai, satu peristiwa item bagi setiap perkataan, kemudian done. Perkataan anda akan berbeza daripada 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. Apabila sejam berlalu

Panggilan menjawab 401. Jalankan langkah 3 sekali lagi. Jika langkah 3 kini gagal, klien atau rahsianya telah berubah pada halaman Integrasi. Program mengikut peraturan panduan Pengesahan: tukar semula sekali bagi setiap 401, dan berhenti jika pertukaran gagal.

Jika terjemahan dan rujukan bahasa Inggeris berbeza, rujukan bahasa Inggeris adalah yang betul.