Αποστολή συμβάντος

Έκδοση API 2026-10-affable-towhee

post https://api.getlingara.com/v1/events

Ενημερώνει το Lingara για ό,τι συνέβη στο παιχνίδι σας, για παράδειγμα ότι ο μαθητής μπήκε σε νέο μέρος. Το συμβάν καταγράφεται μία φορά και απαντάται με 202. Με generate: true το Lingara ξεκινά επίσης ένα πλάνο μαθήματος, που απαιτεί lesson_plans:write και έχει τα ίδια όρια και την ίδια χρέωση με το POST /v1/lesson-plans: το reaction κατονομάζει το πλάνο, και ακολουθεί lesson_plan.ready ή lesson_plan.failed. Περιγράψτε τον κόσμο, ποτέ το όνομα ή τη συνομιλία ενός παίκτη.

Εύρη δικαιωμάτων events:write

Παράμετροι

Lingara-Versionheaderstringπροαιρετικό: Η έκδοση API με την οποία απαντάται αυτό το αίτημα. Χωρίς αυτήν, ένα token πρόσβασης παίρνει την έκδοση στην οποία είναι δεσμευμένος ο πελάτης του και ένα αίτημα χωρίς token παίρνει την τρέχουσα έκδοση. Η έκδοση που βρίσκεται ακόμη υπό ανάπτυξη είναι προσβάσιμη μόνο αν την ονομάσετε εδώ. Μια άγνωστη έκδοση απαντάται με 400 και κωδικό api_version_unknown. Το GET /v1/versions παραθέτει τις εκδόσεις.
Idempotency-Keyheaderstringυποχρεωτικό: Μια τιμή που επιλέγετε για κάθε συμβάν και ξαναστέλνετε όταν επαναλαμβάνετε το αίτημα: 1 έως 255 ορατοί χαρακτήρες ASCII, όπως ένα UUID. Μια επανάληψη με το ίδιο κλειδί λαμβάνει την πρώτη απάντηση και δεν χρεώνεται ξανά, ακόμη κι αν το περιεχόμενό της διαφέρει. Χωρίς έγκυρο κλειδί το αίτημα απαντά 400 με κωδικό idempotency_key_required.

Σώμα αιτήματος `application/json`

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

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

topicstringυποχρεωτικό
source_langstringυποχρεωτικό
target_langstringυποχρεωτικό
levelintegerυποχρεωτικό
tagsarray of stringπροαιρετικό
generateboolean | nullπροαιρετικό

Αποκρίσεις

202 Το συμβάν καταγράφηκε

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

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

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

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

statusReactionStatusυποχρεωτικό
plan_idstring | nullπροαιρετικό
plan_statusPlanStatus | nullπροαιρετικό: Η κατάσταση του πλάνου όταν έγινε δεκτό το συμβάν. Μόνο το generating υπόσχεται ότι θα ακολουθήσει lesson_plan.ready ή lesson_plan.failed. Κάθε άλλη τιμή είναι πλάνο από τη βιβλιοθήκη, που μπορείτε να διαβάσετε τώρα με GET /v1/lesson-plans/{id}.
codestring | nullπροαιρετικό
errorstring | nullπροαιρετικό

Σφάλματα

402application/json: Η κλήση ενός πελάτη με χρέωση βάσει χρήσης απορρίφθηκε πριν καταναλώσει οτιδήποτε. spend_cap_reached: ο πελάτης ή ο λογαριασμός του έφτασε το μηνιαίο όριο δαπανών του· αυξήστε το όριο στη σελίδα Ενσωματώσεις. metered_billing_inactive: η χρέωση βάσει χρήσης δεν είναι ενεργή για αυτόν τον λογαριασμό· ρυθμίστε την ή ενημερώστε τον τρόπο πληρωμής στη σελίδα Ενσωματώσεις.
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υποχρεωτικό

Παράδειγμα

curl -X POST "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"world.context_changed","data":{"scene":"A night market in Taipei, just after rain","npc":{"name":"Auntie Lin","persona":"a street-food vendor who likes to haggle"},"source_lang":"en","target_lang":"zh","level":3,"tags":["market","food","chapter-2"],"generate":true}}'

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