शब्दावली सूची बनाएँ
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: {}यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।