Επανασύνδεση σε σχέδιο μαθήματος
Έκδοση API 2026-10-affable-towhee
Επανασυνδέεται στη ροή προόδου ενός σχεδίου που δημιουργείται ακόμη. Ένα ολοκληρωμένο σχέδιο απαντά με ένα result. Ένα σχέδιο που δημιουργείται ακόμη χωρίς ενεργή ροή για σύνδεση απαντά με ένα pending· καλείτε περιοδικά το GET /v1/lesson-plans/{id} μέχρι να ολοκληρωθεί.
Εύρη δικαιωμάτων lesson_plans:read
Παράμετροι
Lingara-Versionheaderstringπροαιρετικό- Η έκδοση API με την οποία απαντάται αυτό το αίτημα. Χωρίς αυτήν, ένα token πρόσβασης παίρνει την έκδοση στην οποία είναι δεσμευμένος ο πελάτης του και ένα αίτημα χωρίς token παίρνει την τρέχουσα έκδοση. Η έκδοση που βρίσκεται ακόμη υπό ανάπτυξη είναι προσβάσιμη μόνο αν την ονομάσετε εδώ. Μια άγνωστη έκδοση απαντάται με
400και κωδικόapi_version_unknown. ΤοGET /v1/versionsπαραθέτει τις εκδόσεις. idpathstringυποχρεωτικό
Αποκρίσεις
200 Η υπόλοιπη πρόοδος του σχεδίου, έπειτα το σχέδιο
Συμβάντα ροής text/event-stream
Στέλνει ένα σχόλιο keepalive κάθε 15 δευτερόλεπτα.
-
startedPlanStarted -
plan_idstringυποχρεωτικό
-
phasePlanPhase -
phasestringυποχρεωτικόattemptintegerυποχρεωτικό
-
resultPlanResult Τερματίζει τη ροή -
planLessonPlanυποχρεωτικόidstringυποχρεωτικόstatusPlanStatusυποχρεωτικόtitlestring | nullπροαιρετικόsource_langstringυποχρεωτικόtarget_langstringυποχρεωτικόlevelintegerυποχρεωτικόcreated_atstringυποχρεωτικόcompleted_atstring | nullπροαιρετικόai_generatedbooleanυποχρεωτικόcontentLessonPlanContent | nullπροαιρετικόintroductionstring | nullπροαιρετικόlearning_objectivesarray of stringυποχρεωτικόvocabularyarray of PlanWordυποχρεωτικόwordstringυποχρεωτικόpronunciationstring | nullπροαιρετικόtranslationstringυποχρεωτικό
setsarray of PlanSetυποχρεωτικόnumberintegerυποχρεωτικόcontextstring | nullπροαιρετικόquestionsarray of PlanQuestionυποχρεωτικόtypestringυποχρεωτικόpromptstringυποχρεωτικόoptionsarray of string | nullπροαιρετικόanswerstringυποχρεωτικόexplanationstringυποχρεωτικόhintstring | nullπροαιρετικό
-
pendingPlanPending Τερματίζει τη ροή -
plan_idstringυποχρεωτικόstatusPlanStatusυποχρεωτικό
-
errorStreamError Τερματίζει τη ροή -
Φτάνει μέσα στην απόκριση 200. Η γραμμή κατάστασης έχει ήδη σταλεί, οπότε μια αποτυχία μετά το άνοιγμα της ροής αναφέρεται ως αυτό το συμβάν.
codestringυποχρεωτικόmessagestringυποχρεωτικόplan_idstring | nullπροαιρετικό
Σφάλματα
410application/json- Η έκδοση API με την οποία απαντάται αυτό το αίτημα έχει καταργηθεί. Στείλτε μια υποστηριζόμενη έκδοση στο
Lingara-Versionή συνδέστε τον πελάτη με άλλη έκδοση. 4XXapplication/json- Το αίτημα απορρίφθηκε. Το
codeλέει γιατί και τοerrorτο εξηγεί με λόγια. 503application/json · text/plain- Η υπηρεσία δεν είναι προσωρινά διαθέσιμη· δοκιμάστε ξανά μετά τον αριθμό δευτερολέπτων στο
Retry-After. Κατά τη συντήρηση, το σώμα είναι απλό κείμενο αντί για τον φάκελο σφάλματος. 5XXapplication/json- Το αίτημα απορρίφθηκε. Το
codeλέει γιατί και τοerrorτο εξηγεί με λόγια.
codestringυποχρεωτικόΓιατί απορρίφθηκε το αίτημα, ως σταθερός κωδικός για διακλάδωση: για παράδειγμα
insufficient_scope(403),rate_limited(429) και, για πελάτη με χρέωση βάσει χρήσης,spend_cap_reached(402) καιmetered_billing_inactive(402).errorstringυποχρεωτικό
Παράδειγμα
Προτιμάτε μια βιβλιοθήκη; Δείτε την ενότητα Βιβλιοθήκες.
Παράδειγμα ροής
event: pending
data: {"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"generating"}Αν μια μετάφραση διαφέρει από την αγγλική τεκμηρίωση, ισχύει η αγγλική τεκμηρίωση.