Kết nối lại với giáo án
Phiên bản API 2026-10-affable-towhee
Tham gia lại luồng tiến trình của giáo án vẫn đang được tạo. Giáo án đã hoàn tất trả về một result. Giáo án vẫn đang được tạo nhưng không có luồng trực tiếp để tham gia sẽ trả về một pending; hãy thăm dò GET /v1/lesson-plans/{id} cho đến khi hoàn tất.
Phạm vi lesson_plans:read
Tham số
Lingara-Versionheaderstringtùy chọn- Phiên bản API dùng để trả lời yêu cầu này. Nếu không có, token truy cập nhận phiên bản mà ứng dụng khách của nó được gắn, còn yêu cầu không có token nhận phiên bản hiện tại. Phiên bản đang phát triển chỉ có thể dùng bằng cách nêu tên nó ở đây. Phiên bản không xác định được trả lời bằng
400với mãapi_version_unknown.GET /v1/versionsliệt kê các phiên bản. idpathstringbắt buộc
Phản hồi
200 Phần tiến trình còn lại của giáo án, sau đó là giáo án
Sự kiện luồng text/event-stream
Gửi một chú thích keepalive mỗi 15 giây.
-
startedPlanStarted -
plan_idstringbắt buộc
-
phasePlanPhase -
phasestringbắt buộcattemptintegerbắt buộc
-
resultPlanResult Kết thúc luồng -
planLessonPlanbắt buộcidstringbắt buộcstatusPlanStatusbắt buộctitlestring | nulltùy chọnsource_langstringbắt buộctarget_langstringbắt buộclevelintegerbắt buộccreated_atstringbắt buộccompleted_atstring | nulltùy chọnai_generatedbooleanbắt buộccontentLessonPlanContent | nulltùy chọnintroductionstring | nulltùy chọnlearning_objectivesarray of stringbắt buộcvocabularyarray of PlanWordbắt buộcwordstringbắt buộcpronunciationstring | nulltùy chọntranslationstringbắt buộc
setsarray of PlanSetbắt buộcnumberintegerbắt buộccontextstring | nulltùy chọnquestionsarray of PlanQuestionbắt buộctypestringbắt buộcpromptstringbắt buộcoptionsarray of string | nulltùy chọnanswerstringbắt buộcexplanationstringbắt buộchintstring | nulltùy chọn
-
pendingPlanPending Kết thúc luồng -
plan_idstringbắt buộcstatusPlanStatusbắt buộc
-
errorStreamError Kết thúc luồng -
Đến bên trong phản hồi 200. Dòng trạng thái đã được gửi, nên lỗi xảy ra sau khi luồng mở được báo bằng sự kiện này.
codestringbắt buộcmessagestringbắt buộcplan_idstring | nulltùy chọn
Lỗi
410application/json- Phiên bản API dùng để trả lời yêu cầu này đã bị ngừng. Hãy gửi một phiên bản được hỗ trợ trong
Lingara-Version, hoặc gắn ứng dụng khách với một phiên bản khác. 4XXapplication/json- Yêu cầu đã bị từ chối.
codecho biết lý do, vàerrordiễn đạt lý do đó bằng lời. 503application/json · text/plain- Dịch vụ tạm thời không khả dụng; hãy thử lại sau số giây ghi trong
Retry-After. Trong thời gian bảo trì, phần thân là văn bản thuần thay vì phong bì lỗi. 5XXapplication/json- Yêu cầu đã bị từ chối.
codecho biết lý do, vàerrordiễn đạt lý do đó bằng lời.
codestringbắt buộcLý do yêu cầu bị từ chối, dưới dạng một mã ổn định để rẽ nhánh: ví dụ
insufficient_scope(403),rate_limited(429) và, với ứng dụng khách tính phí theo mức dùng,spend_cap_reached(402) vàmetered_billing_inactive(402).errorstringbắt buộc
Ví dụ
Muốn dùng thư viện? Xem mục Thư viện.
Luồng ví dụ
event: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}Nếu bản dịch và tài liệu tham chiếu tiếng Anh khác nhau, tài liệu tham chiếu tiếng Anh là bản đúng.