Ders planına yeniden bağlan
API sürümü 2026-10-affable-towhee
Hâlâ oluşturulmakta olan bir planın ilerleme akışına yeniden katılır. Tamamlanmış bir plan tek bir result ile yanıt verir. Hâlâ oluşturulan ve katılınacak canlı bir akışı olmayan bir plan tek bir pending ile yanıt verir; tamamlanana kadar GET /v1/lesson-plans/{id} adresini yoklayın.
Kapsamlar lesson_plans:read
Parametreler
Lingara-Versionheaderstringisteğe bağlı- Bu isteğin yanıtlanacağı API sürümü. Belirtilmezse bir erişim token'ı istemcisinin bağlı olduğu sürümü, token içermeyen bir istek ise güncel sürümü alır. Hâlâ geliştirilmekte olan sürüme yalnızca burada adı verilerek ulaşılır. Bilinmeyen bir sürüm
400veapi_version_unknownkoduyla yanıtlanır.GET /v1/versionssürümleri listeler. idpathstringzorunlu
Yanıtlar
200 Planın kalan ilerlemesi, ardından plan
Akış olayları text/event-stream
Her 15 saniyede bir keepalive yorumu gönderir.
-
startedPlanStarted -
plan_idstringzorunlu
-
phasePlanPhase -
phasestringzorunluattemptintegerzorunlu
-
resultPlanResult Akışı sonlandırır -
planLessonPlanzorunluidstringzorunlustatusPlanStatuszorunlutitlestring | nullisteğe bağlısource_langstringzorunlutarget_langstringzorunlulevelintegerzorunlucreated_atstringzorunlucompleted_atstring | nullisteğe bağlıai_generatedbooleanzorunlucontentLessonPlanContent | nullisteğe bağlıintroductionstring | nullisteğe bağlılearning_objectivesarray of stringzorunluvocabularyarray of PlanWordzorunluwordstringzorunlupronunciationstring | nullisteğe bağlıtranslationstringzorunlu
setsarray of PlanSetzorunlunumberintegerzorunlucontextstring | nullisteğe bağlıquestionsarray of PlanQuestionzorunlutypestringzorunlupromptstringzorunluoptionsarray of string | nullisteğe bağlıanswerstringzorunluexplanationstringzorunluhintstring | nullisteğe bağlı
-
pendingPlanPending Akışı sonlandırır -
plan_idstringzorunlustatusPlanStatuszorunlu
-
errorStreamError Akışı sonlandırır -
200 yanıtının içinde gelir. Durum satırı zaten gönderilmiş olduğundan, akış açıldıktan sonraki bir hata bu olay olarak bildirilir.
codestringzorunlumessagestringzorunluplan_idstring | nullisteğe bağlı
Hatalar
410application/json- Bu isteğin yanıtlandığı API sürümü sonlandırıldı.
Lingara-Versioniçinde desteklenen bir sürüm gönderin veya istemciyi başka bir sürüme bağlayın. 4XXapplication/json- İstek reddedildi.
codenedenini belirtir,errorise bunu sözcüklerle açıklar. 503application/json · text/plain- Hizmet geçici olarak kullanılamıyor;
Retry-Afteriçindeki saniye sayısı kadar bekledikten sonra yeniden deneyin. Bakım sırasında gövde, hata zarfı yerine düz metindir. 5XXapplication/json- İstek reddedildi.
codenedenini belirtir,errorise bunu sözcüklerle açıklar.
codestringzorunluİsteğin neden reddedildiği, dallanmak için kullanılabilecek sabit bir kod olarak: örneğin
insufficient_scope(403),rate_limited(429) ve kullanım başına ücretlendirilen bir istemci içinspend_cap_reached(402) ilemetered_billing_inactive(402).errorstringzorunlu
Örnek
Kütüphane mi tercih edersiniz? Kütüphaneler bölümüne bakın.
Örnek akış
event: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}Bir çeviri ile İngilizce referans arasında fark varsa, İngilizce referans geçerlidir.