Ji nû ve bi planeke dersê ve girê bide
Guhertoya API 2026-10-affable-towhee
Ji nû ve beşdarî streama pêşketinê ya planeke ku hê tê çêkirin dibe. Planeke qediyayî bi resultekî bersiv dide. Planeke ku hê tê çêkirin û streameke zindî ya beşdarbûnê tune bi pendingekî bersiv dide; heta ku biqede GET /v1/lesson-plans/{id} dubare bipirse.
Scope lesson_plans:read
Parametre
Lingara-Versionheaderstringvebijarkî- Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi
400û kodaapi_version_unknowntê bersivandin.GET /v1/versionsguhertoyan rêz dike. idpathstringpêwîst
Bersiv
200 Pêşketina mayî ya planê, paşê plan
Bûyerên streamê text/event-stream
Her 15 çirkeyan şîroveyeke keepalive dişîne.
-
startedPlanStarted -
plan_idstringpêwîst
-
phasePlanPhase -
phasestringpêwîstattemptintegerpêwîst
-
resultPlanResult Weşanê diqedîne -
planLessonPlanpêwîstidstringpêwîststatusPlanStatuspêwîsttitlestring | nullvebijarkîsource_langstringpêwîsttarget_langstringpêwîstlevelintegerpêwîstcreated_atstringpêwîstcompleted_atstring | nullvebijarkîai_generatedbooleanpêwîstcontentLessonPlanContent | nullvebijarkîintroductionstring | nullvebijarkîlearning_objectivesarray of stringpêwîstvocabularyarray of PlanWordpêwîstwordstringpêwîstpronunciationstring | nullvebijarkîtranslationstringpêwîst
setsarray of PlanSetpêwîstnumberintegerpêwîstcontextstring | nullvebijarkîquestionsarray of PlanQuestionpêwîsttypestringpêwîstpromptstringpêwîstoptionsarray of string | nullvebijarkîanswerstringpêwîstexplanationstringpêwîsthintstring | nullvebijarkî
-
pendingPlanPending Weşanê diqedîne -
plan_idstringpêwîststatusPlanStatuspêwîst
-
errorStreamError Weşanê diqedîne -
Di nav bersiva 200 de tê. Rêza rewşê berê hatiye şandin, ji ber vê yekê têkçûnek piştî vebûna weşanê wekî vê bûyerê tê ragihandin.
codestringpêwîstmessagestringpêwîstplan_idstring | nullvebijarkî
Çewtî
410application/json- Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di
Lingara-Versionde bişîne, an klientê bi guhertoyeke din ve girê bide. 4XXapplication/json- Daxwaz hate redkirin.
codesedemê dibêje, ûerrorwê bi gotinan dibêje. 503application/json · text/plain- Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di
Retry-Afterde dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê. 5XXapplication/json- Daxwaz hate redkirin.
codesedemê dibêje, ûerrorwê bi gotinan dibêje.
codestringpêwîstÇima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne
insufficient_scope(403),rate_limited(429) û, ji bo klienteke pîvandî,spend_cap_reached(402) ûmetered_billing_inactive(402).errorstringpêwîst
Mînak
Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.
Mînaka streamê
event: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}Ger wergerek û referansa Îngilîzî ji hev cuda bin, referansa Îngilîzî rast e.