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