पाठ योजना से दोबारा जुड़ें
API संस्करण 2026-10-affable-towhee
अभी बन रही योजना की प्रगति स्ट्रीम में फिर से शामिल होता है। पूरी हो चुकी योजना एक result से जवाब देती है। जो योजना अभी बन रही है पर जिसकी कोई लाइव स्ट्रीम नहीं है, वह एक pending से जवाब देती है; पूरी होने तक GET /v1/lesson-plans/{id} को पोल करें।
स्कोप lesson_plans:read
पैरामीटर
Lingara-Versionheaderstringवैकल्पिक- वह API संस्करण जिसके अंतर्गत इस अनुरोध का उत्तर दिया जाए। इसके बिना, एक्सेस टोकन को वह संस्करण मिलता है जिससे उसका क्लाइंट जुड़ा है, और बिना टोकन वाले अनुरोध को वर्तमान संस्करण मिलता है। विकासाधीन संस्करण तक केवल उसे यहाँ नाम देकर पहुँचा जा सकता है। अज्ञात संस्करण का उत्तर
400और कोडapi_version_unknownहोता है।GET /v1/versionsसंस्करणों की सूची देता है। idpathstringआवश्यक
प्रतिक्रियाएँ
200 योजना की बची हुई प्रगति, फिर योजना
स्ट्रीम इवेंट text/event-stream
हर 15 सेकंड में एक keepalive टिप्पणी भेजता है।
-
startedPlanStarted -
plan_idstringआवश्यक
-
phasePlanPhase -
phasestringआवश्यकattemptintegerआवश्यक
-
resultPlanResult स्ट्रीम समाप्त करता है -
planLessonPlanआवश्यकidstringआवश्यकstatusPlanStatusआवश्यकtitlestring | nullवैकल्पिकsource_langstringआवश्यकtarget_langstringआवश्यकlevelintegerआवश्यकcreated_atstringआवश्यकcompleted_atstring | nullवैकल्पिकai_generatedbooleanआवश्यकcontentLessonPlanContent | nullवैकल्पिकintroductionstring | nullवैकल्पिकlearning_objectivesarray of stringआवश्यकvocabularyarray of PlanWordआवश्यकwordstringआवश्यकpronunciationstring | nullवैकल्पिकtranslationstringआवश्यक
setsarray of PlanSetआवश्यकnumberintegerआवश्यकcontextstring | nullवैकल्पिकquestionsarray of PlanQuestionआवश्यकtypestringआवश्यकpromptstringआवश्यकoptionsarray of string | nullवैकल्पिकanswerstringआवश्यकexplanationstringआवश्यकhintstring | nullवैकल्पिक
-
pendingPlanPending स्ट्रीम समाप्त करता है -
plan_idstringआवश्यकstatusPlanStatusआवश्यक
-
errorStreamError स्ट्रीम समाप्त करता है -
200 प्रतिक्रिया के भीतर आता है। स्थिति पंक्ति पहले ही भेजी जा चुकी है, इसलिए स्ट्रीम खुलने के बाद की विफलता इस इवेंट के रूप में बताई जाती है।
codestringआवश्यकmessagestringआवश्यकplan_idstring | nullवैकल्पिक
त्रुटियाँ
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: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}यदि किसी अनुवाद और अंग्रेज़ी संदर्भ में अंतर हो, तो अंग्रेज़ी संदर्भ ही मान्य है।