បង្កើតផែនការមេរៀន
កំណែ API 2026-10-affable-towhee
ចាប់ផ្តើមបង្កើតផែនការមេរៀន ហើយផ្សាយវឌ្ឍនភាពរបស់វា។ started ប្រាប់ឈ្មោះផែនការភ្លាមៗពេលវាមាន ដូច្នេះការតភ្ជាប់ដែលដាច់អាចភ្ជាប់ឡើងវិញដោយប្រើ GET /v1/lesson-plans/{id}/stream។ ស្ទ្រីមបញ្ចប់ដោយ result ឬ error។ ផែនការដែលផ្តល់ពីបណ្ណាល័យមកដល់ជា result តែមួយ។
វិសាលភាព lesson_plans:write
ប៉ារ៉ាម៉ែត្រ
Lingara-Versionheaderstringស្រេចចិត្ត- កំណែ API ដែលត្រូវប្រើឆ្លើយសំណើនេះ។ បើគ្មានវាទេ token ចូលប្រើទទួលបានកំណែដែលម៉ាស៊ីនភ្ញៀវរបស់វាត្រូវបានភ្ជាប់ ហើយសំណើដែលគ្មាន token ទទួលបានកំណែបច្ចុប្បន្ន។ កំណែដែលកំពុងអភិវឌ្ឍអាចចូលដល់បានតែដោយដាក់ឈ្មោះវានៅទីនេះប៉ុណ្ណោះ។ កំណែដែលមិនស្គាល់ឆ្លើយតប
400ជាមួយកូដapi_version_unknown។GET /v1/versionsបង្ហាញបញ្ជីកំណែ។
ខ្លឹមសារសំណើ application/json
contextstringចាំបាច់source_langstringចាំបាច់target_langstringចាំបាច់levelintegerចាំបាច់
ការឆ្លើយតប
200 វឌ្ឍនភាពនៃផែនការ បន្ទាប់មកផែនការ
ព្រឹត្តិការណ៍ស្ទ្រីម text/event-stream
ផ្ញើមតិ keepalive រៀងរាល់ 15 វិនាទី។
-
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."}]}]}}}ប្រសិនបើការបកប្រែ និងឯកសារយោងជាភាសាអង់គ្លេសខុសគ្នា ឯកសារយោងជាភាសាអង់គ្លេសគឺជាឯកសារដែលត្រឹមត្រូវ។