Opnieuw verbinden met een lesplan
API-versie 2026-10-affable-towhee
Sluit opnieuw aan bij de voortgangsstream van een plan dat nog wordt gegenereerd. Een voltooid plan antwoordt met één result. Een plan dat nog wordt gegenereerd zonder actieve stream om bij aan te sluiten, antwoordt met één pending; poll GET /v1/lesson-plans/{id} totdat het voltooid is.
Bevoegdheden lesson_plans:read
Parameters
Lingara-Versionheaderstringoptioneel- De API-versie waaronder dit verzoek wordt beantwoord. Zonder deze krijgt een toegangstoken de versie waaraan zijn client is gekoppeld, en een verzoek zonder token de huidige versie. De versie die nog in ontwikkeling is, bereik je alleen door die hier te noemen. Een onbekende versie geeft
400met codeapi_version_unknown.GET /v1/versionstoont de versies. idpathstringverplicht
Antwoorden
200 De resterende voortgang van het plan, daarna het plan
Stream-events text/event-stream
Stuurt elke 15 seconden een keepalive-commentaar.
-
startedPlanStarted -
plan_idstringverplicht
-
phasePlanPhase -
phasestringverplichtattemptintegerverplicht
-
resultPlanResult Beëindigt de stream -
planLessonPlanverplichtidstringverplichtstatusPlanStatusverplichttitlestring | nulloptioneelsource_langstringverplichttarget_langstringverplichtlevelintegerverplichtcreated_atstringverplichtcompleted_atstring | nulloptioneelai_generatedbooleanverplichtcontentLessonPlanContent | nulloptioneelintroductionstring | nulloptioneellearning_objectivesarray of stringverplichtvocabularyarray of PlanWordverplichtwordstringverplichtpronunciationstring | nulloptioneeltranslationstringverplicht
setsarray of PlanSetverplichtnumberintegerverplichtcontextstring | nulloptioneelquestionsarray of PlanQuestionverplichttypestringverplichtpromptstringverplichtoptionsarray of string | nulloptioneelanswerstringverplichtexplanationstringverplichthintstring | nulloptioneel
-
pendingPlanPending Beëindigt de stream -
plan_idstringverplichtstatusPlanStatusverplicht
-
errorStreamError Beëindigt de stream -
Komt binnen het 200-antwoord aan. De statusregel is al verzonden, dus een fout nadat de stream is geopend wordt als deze gebeurtenis gemeld.
codestringverplichtmessagestringverplichtplan_idstring | nulloptioneel
Fouten
410application/json- De API-versie waaronder dit verzoek wordt beantwoord, is stopgezet. Stuur een ondersteunde versie mee in
Lingara-Version, of koppel de client aan een andere versie. 4XXapplication/json- Het verzoek is geweigerd.
codegeeft de reden aan enerrorbeschrijft die in woorden. 503application/json · text/plain- De dienst is tijdelijk niet beschikbaar; probeer het opnieuw na het aantal seconden in
Retry-After. Tijdens onderhoud is de body platte tekst in plaats van de foutenvelop. 5XXapplication/json- Het verzoek is geweigerd.
codegeeft de reden aan enerrorbeschrijft die in woorden.
codestringverplichtWaarom het verzoek is geweigerd, als stabiele code om op te vertakken: bijvoorbeeld
insufficient_scope(403),rate_limited(429) en, voor een client met verbruiksafrekening,spend_cap_reached(402) enmetered_billing_inactive(402).errorstringverplicht
Voorbeeld
Liever een bibliotheek? Zie de sectie Bibliotheken.
Voorbeeldstream
event: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}Als een vertaling afwijkt van de Engelse referentie, is de Engelse referentie juist.