د لغتونو لیست جوړول
د API نسخه 2026-10-affable-towhee
په غوښتل شوې کچه د کلمو لیست د جریان په ډول لېږي. جریان لومړی د لیست له جزئیاتو سره started لېږي، بیا د هرې کلمې لپاره یوه item پېښه، او بیا done. تر هغه چې لیست چمتو شي، یوازې keepalive تبصرې لېږي.
ساحې vocab:generate
پیرامیټرونه
Lingara-Versionheaderstringاختیاري- د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي. له دې پرته، لاسرسي ټوکن هغه نسخه ترلاسه کوي چې د هغه کلاینټ ورسره تړل شوی، او بې ټوکنه غوښتنه اوسنۍ نسخه ترلاسه کوي. هغې نسخې ته چې لا هم د پراختیا په حال کې ده یوازې دلته د هغې په نومولو رسېدای شئ. نامعلومې نسخې ته د
400او کوډapi_version_unknownسره ځواب ورکول کېږي.GET /v1/versionsنسخې لېست کوي.
د غوښتنې بدنه application/json
levelintegerاړینsource_langstringاړینtarget_langstringاړینcountinteger | nullاختیاري
ځوابونه
200 لیست، په هره پېښه کې یوه کلمه
د جریان پېښې text/event-stream
هرو 15 ثانیو کې یوه keepalive تبصره لېږي.
-
startedVocabStarted -
metaVocabMetaاړینlevelintegerاړینsource_langstringاړینtarget_langstringاړینframeworkstringاړینcountintegerاړینai_generatedbooleanاړین
-
itemVocabItem -
wordstringاړینpronunciationstring | nullاختیاريreadingstring | nullاختیاريtranslationstringاړینexampleVocabExample | nullاختیاريsentencestringاړینtranslationstringاړین
image_urlstring | nullاختیاري
-
doneDone جریان پای ته رسوي -
errorStreamError جریان پای ته رسوي -
د 200 ځواب دننه رارسېږي. د حالت کرښه دمخه لېږل شوې ده، نو د جریان له پرانیستو وروسته هره ناکامي د دې پېښې په توګه راپور کېږي.
codestringاړینmessagestringاړینplan_idstring | nullاختیاري
تېروتنې
402application/json- د کارونې له مخې بیل کېدونکي پېرودونکي غوښتنه مخکې له دې چې څه ولګوي رد شوه.
spend_cap_reached: پېرودونکی یا د هغه حساب خپلې میاشتنۍ لګښت پولې ته رسېدلی؛ پوله د یوځای کېدنو په پاڼه کې لوړه کړئ.metered_billing_inactive: د دې حساب لپاره د کارونې له مخې بیل فعال نه دی؛ هغه د یوځای کېدنو په پاڼه کې تنظیم کړئ یا د تادیې طریقه تازه کړئ. 410application/json- د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي بنده شوې ده. په
Lingara-Versionکې یوه ملاتړ شوې نسخه ولېږئ، یا کلاینټ له بلې نسخې سره وتړئ. 4XXapplication/json- غوښتنه رد شوه.
codeلامل ښیي، اوerrorیې په کلمو بیانوي. 503application/json · text/plain- خدمت په لنډمهاله توګه نه شته؛ د هغو ثانیو له تېرېدو وروسته بیا هڅه وکړئ چې په
Retry-Afterکې راغلي دي. د ساتنې پر مهال، د ځواب بدنه د تېروتنې د پاکټ پر ځای ساده متن وي. 5XXapplication/json- غوښتنه رد شوه.
codeلامل ښیي، اوerrorیې په کلمو بیانوي.
codestringاړینولې غوښتنه رد شوه، د یو ثابت کوډ په توګه چې پر بنسټ یې پرېکړه کولی شئ: د بېلګې په توګه
insufficient_scope(403)،rate_limited(429) او، د کارونې له مخې بیل کېدونکي پېرودونکي لپاره،spend_cap_reached(402) اوmetered_billing_inactive(402).errorstringاړین
بېلګه
کتابتون غوره بولئ؟ د کتابتونونو برخه وګورئ.
د جریان بېلګه
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: {}که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.