د درس پلان ته بیا وصلېدل
د 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"}که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.