Reconectarse a un plan de lección
Versión de la API 2026-10-affable-towhee
Vuelve a unirse al flujo de progreso de un plan que aún se está generando. Un plan terminado responde con un único result. Un plan que aún se está generando sin un flujo activo al que unirse responde con un único pending; consulta GET /v1/lesson-plans/{id} periódicamente hasta que esté completo.
Ámbitos lesson_plans:read
Parámetros
Lingara-Versionheaderstringopcional- La versión de la API con la que se responde a esta solicitud. Sin ella, un token de acceso recibe la versión a la que está vinculado su cliente, y una solicitud sin token recibe la versión actual. La versión aún en desarrollo solo se alcanza nombrándola aquí. Una versión desconocida responde
400con el códigoapi_version_unknown.GET /v1/versionsenumera las versiones. idpathstringobligatorio
Respuestas
200 El progreso restante del plan y luego el plan
Eventos del flujo text/event-stream
Envía un comentario keepalive cada 15 segundos.
-
startedPlanStarted -
plan_idstringobligatorio
-
phasePlanPhase -
phasestringobligatorioattemptintegerobligatorio
-
resultPlanResult Termina el flujo -
planLessonPlanobligatorioidstringobligatoriostatusPlanStatusobligatoriotitlestring | nullopcionalsource_langstringobligatoriotarget_langstringobligatoriolevelintegerobligatoriocreated_atstringobligatoriocompleted_atstring | nullopcionalai_generatedbooleanobligatoriocontentLessonPlanContent | nullopcionalintroductionstring | nullopcionallearning_objectivesarray of stringobligatoriovocabularyarray of PlanWordobligatoriowordstringobligatoriopronunciationstring | nullopcionaltranslationstringobligatorio
setsarray of PlanSetobligatorionumberintegerobligatoriocontextstring | nullopcionalquestionsarray of PlanQuestionobligatoriotypestringobligatoriopromptstringobligatoriooptionsarray of string | nullopcionalanswerstringobligatorioexplanationstringobligatoriohintstring | nullopcional
-
pendingPlanPending Termina el flujo -
plan_idstringobligatoriostatusPlanStatusobligatorio
-
errorStreamError Termina el flujo -
Llega dentro de la respuesta 200. La línea de estado ya se ha enviado, así que un fallo después de abrirse el flujo se notifica como este evento.
codestringobligatoriomessagestringobligatorioplan_idstring | nullopcional
Errores
410application/json- La versión de la API con la que se responde a esta solicitud se ha retirado. Envía una versión admitida en
Lingara-Versiono vincula el cliente a otra versión. 4XXapplication/json- La solicitud fue rechazada.
codeindica el motivo yerrorlo explica con palabras. 503application/json · text/plain- El servicio no está disponible temporalmente; vuelve a intentarlo tras el número de segundos indicado en
Retry-After. Durante el mantenimiento, el cuerpo es texto sin formato en lugar del sobre de error. 5XXapplication/json- La solicitud fue rechazada.
codeindica el motivo yerrorlo explica con palabras.
codestringobligatorioPor qué se rechazó la solicitud, como un código estable con el que ramificar: por ejemplo
insufficient_scope(403),rate_limited(429) y, para un cliente con facturación por uso,spend_cap_reached(402) ymetered_billing_inactive(402).errorstringobligatorio
Ejemplo
¿Prefieres una biblioteca? Consulta la sección Bibliotecas.
Ejemplo de flujo
event: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.