إنشاء قائمة مفردات
إصدار API 2026-10-affable-towhee
post https://api.getlingara.com/v1/vocab/stream
يبثّ قائمة كلمات بالمستوى المطلوب. يرسل البث 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
يرسل تعليق إبقاء الاتصال (keepalive) كل 15 ثانية.
-
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: {}إذا اختلفت ترجمةٌ عن المرجع الإنجليزي، فالمرجع الإنجليزي هو الصحيح.