ساخت فهرست واژگان
نسخهٔ 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: {}اگر ترجمه با مرجع انگلیسی تفاوت داشته باشد، مرجع انگلیسی معتبر است.