دروستکردنی لیستی وشە
وەشانی 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: {}ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.