Ροή συμβάντων

Παράμετροι

Lingara-Versionheaderstringπροαιρετικό

Η έκδοση API με την οποία απαντάται αυτό το αίτημα. Χωρίς αυτήν, ένα token πρόσβασης παίρνει την έκδοση στην οποία είναι δεσμευμένος ο πελάτης του και ένα αίτημα χωρίς token παίρνει την τρέχουσα έκδοση. Η έκδοση που βρίσκεται ακόμη υπό ανάπτυξη είναι προσβάσιμη μόνο αν την ονομάσετε εδώ. Μια άγνωστη έκδοση απαντάται με 400 και κωδικό api_version_unknown. Το GET /v1/versions παραθέτει τις εκδόσεις.

Last-Event-IDheaderstringπροαιρετικό

Το id: του τελευταίου συμβάντος που λάβατε. Έχει προτεραιότητα έναντι των cursor και start.

cursorquerystringπροαιρετικό

Από πού να συνεχίσετε: το next_cursor μιας προηγούμενης σελίδας ή το id: ενός συμβάντος ροής. Ένας δείκτης παλαιότερος από 30 ημέρες απαντά 410 με κωδικό cursor_expired.

startquerystringπροαιρετικό

Από πού να ξεκινήσετε χωρίς δείκτη: latest για συμβάντα από τώρα και στο εξής ή oldest για κάθε συμβάν που διατηρείται ακόμη.

typesqueryarray of stringπροαιρετικό

Μόνο αυτοί οι τύποι συμβάντων, χωρισμένοι με κόμματα. Χωρίς αυτό, κάθε τύπος που μπορούν να διαβάσουν τα δικαιώματα του διακριτικού σας.

Αποκρίσεις

200 Συμβάντα τη στιγμή που συμβαίνουν, έως done ή error

Συμβάντα ροής text/event-stream

Στέλνει ένα σχόλιο keepalive κάθε 15 δευτερόλεπτα.

event EventEnvelope

idstringυποχρεωτικό

typestringυποχρεωτικό

created_atstringυποχρεωτικό

api_versionstringυποχρεωτικό

subjectstringυποχρεωτικό

dataobjectυποχρεωτικό

done Done Τερματίζει τη ροή

error StreamError Τερματίζει τη ροή

Φτάνει μέσα στην απόκριση 200. Η γραμμή κατάστασης έχει ήδη σταλεί, οπότε μια αποτυχία μετά το άνοιγμα της ροής αναφέρεται ως αυτό το συμβάν.

codestringυποχρεωτικό

messagestringυποχρεωτικό

plan_idstring | nullπροαιρετικό

Σφάλματα

410application/json

api_version_discontinued: η έκδοση API αυτού του αιτήματος έχει καταργηθεί. cursor_expired: ο δείκτης είναι παλαιότερος από 30 ημέρες· ξεκινήστε ξανά χωρίς αυτόν.

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υποχρεωτικό

Παράδειγμα

curl -N "https://api.getlingara.com/v1/events/stream" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

Προτιμάτε μια βιβλιοθήκη; Δείτε την ενότητα Βιβλιοθήκες.

Παράδειγμα ροής

id: djEuNzQ0MTIuOTkxLjE3OTAyNDk1NjQ
event: event
data: {"id":"lgr_evt_4f2a9c1e7b3d4e5f8a9b0c1d2e3f4a5b","type":"lesson_plan.ready","created_at":"2026-10-01T09:12:44Z","api_version":"2026-09-equipped-boxfish","subject":"lgr_sub_0f1e2d3c4b5a69788796a5b4c3d2e1f0","data":{"plan_id":"3f1c2a9e-5b7d-4e21-9a0c-6d8e4f2b1a37","status":"complete","title":"At the night market","source_lang":"en","target_lang":"zh","level":2}}

id: djEuNzQ0MzAuMC4xNzkwMjUwNDY0
event: done
data: {}