چټک پیل

د API نسخه 2026-10-affable-towhee

له هېڅ نه تر یوه جریاني لغتونو لیست پورې پنځه ګامونه: یو پېرودونکی جوړ کړئ، په خپل شل کې یې کېږدئ، د لاسرسي په ټوکن یې بدل کړئ، یوه غوښتنه وکړئ، او کله چې ټوکن پای ته ورسېږي نوی ټوکن ترلاسه کړئ.

1. پېرودونکی جوړ کړئ

د Lingara وېب اپ د یوځای کېدنو په پاڼه کې، په app.getlingara.com/admin کې، د OAuth پېرودونکو لاندې، یو پېرودونکی جوړ کړئ چې «لغتونه جوړ کړئ» وکولی شي (ساحه vocab:generate). د پېرودونکي پېژند او راز یې کاپي کړئ. راز یوازې یو ځل ښودل کېږي.

2. په خپل شل کې یې کېږدئ

د پېرودونکي پېژند او راز د LINGARA_CLIENT_ID او LINGARA_CLIENT_SECRET چاپېریالي متغیرونو کې وساتئ، نو هېڅ راز هېڅکله په کوم امر کې نه لیکل کېږي.

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

3. د لاسرسي ټوکن ترلاسه کړئ

دا امر پېرودونکی د لاسرسي په ټوکن بدلوي او په LINGARA_TOKEN کې یې ساتي، چې په دې مرجع کې هره بېلګه یې لولي. دې ته jq او curl 7.76 یا نوې نسخه اړینه ده. که بدلونه ناکامه شي، امر د تېروتنې کوډ چاپوي (د بېلګې په توګه invalid_client: پېژند او راز وګورئ) او LINGARA_TOKEN تش پرېږدي، نو راتلونکې غوښتنه په 401 ناکامېږي تر هغه چې یوه بدلونه بریالۍ شي. له jq پرته، د هویت تایید له لارښود څخه بدلونه وچلوئ او access_token له ځواب څخه په لاس کاپي کړئ.

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. د لغتونو لیست جوړ کړئ

دا امر وچلوئ. -N د curl بفرینګ بندوي، نو هره پېښه هماغه وخت چاپېږي چې راورسېږي.

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

څه باید ووینئ

د لیست له جزئیاتو سره یوه started پېښه، د هرې کلمې لپاره یوه item پېښه، بیا done. ستاسو کلمې به له دې بېلګې توپیر ولري.

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. کله چې ساعت پوره شي

غوښتنه په 401 ځواب ورکوي. 3 ګام بیا وچلوئ. که 3 ګام اوس ناکام شي، پېرودونکی یا د هغه راز د یوځای کېدنو په پاڼه کې بدل شوی. پروګرام د هویت تایید د لارښود قاعده پلي کوي: د هر 401 لپاره یو ځل بیا بدلونه وکړئ، او که بدلونه ناکامه شي ودرېږئ.

که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.