دەستپێکی خێرا

وەشانی 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 یەک جار دووبارە بیگۆڕەوە، و ئەگەر گۆڕینەوەکە سەرنەکەوت بوەستە.

ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.