دروستکردنی پلانی وانە
وەشانی API 2026-10-affable-towhee
دەست بە دروستکردنی پلانێکی وانە دەکات و پێشکەوتنەکەی بە ستریم دەنێرێت. started هەر کە پلانەکە بوونی هەبوو ناوی دەبات، بۆ ئەوەی پەیوەندییەکی پچڕاو بتوانێت بە GET /v1/lesson-plans/{id}/stream دووبارە پەیوەندی بکاتەوە. ستریمەکە بە result یان error کۆتایی دێت. پلانێک کە لە کتێبخانەوە پێشکەش دەکرێت تەنها وەک یەک result دەگات.
مەوداکانی دەسەڵات lesson_plans:write
پارامەترەکان
Lingara-Versionheaderstringئارەزوومەندانە- ئەو وەشانەی API کە ئەم داواکارییەی پێ وەڵام دەدرێتەوە. بەبێ ئەمە، تۆکنی دەستگەیشتن ئەو وەشانە وەردەگرێت کە کڕیارەکەی پێیەوە بەستراوە، و داواکارییەکی بێ تۆکن وەشانی ئێستا وەردەگرێت. وەشانێک کە هێشتا لە گەشەپێداندایە تەنها بە ناوهێنانی لێرە دەگەیەندرێت. وەشانێکی نەناسراو بە
400لەگەڵ کۆدیapi_version_unknownوەڵام دەدرێتەوە.GET /v1/versionsوەشانەکان لیست دەکات.
ناوەڕۆکی داواکاری application/json
contextstringپێویستsource_langstringپێویستtarget_langstringپێویستlevelintegerپێویست
وەڵامەکان
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ئارەزوومەندانە
-
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: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37"}
event: phase
data: {"phase":"selecting_vocabulary","attempt":1}
event: result
data: {"plan":{"id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"complete","title":"At the night market","source_lang":"en","target_lang":"zh","level":2,"created_at":"2026-09-23T10:00:00Z","completed_at":"2026-09-23T10:00:41Z","ai_generated":true,"content":{"introduction":"Order food and ask prices at a night market.","learning_objectives":["Ask how much something costs"],"vocabulary":[{"word":"多少钱","pronunciation":"duōshao qián","translation":"how much"}],"sets":[{"number":1,"questions":[{"type":"multiple_choice_word","prompt":"Which word asks for a price?","options":["多少钱","谢谢"],"answer":"多少钱","explanation":"多少钱 means how much money."}]}]}}}ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.