Έκδοση token για έναν παίκτη

Έκδοση API 2026-10-virile-dragon

post https://api.getlingara.com/v1/embed/tokens

Εγγυάται για έναν από τους παίκτες σας και επιστρέφει ένα token που το παιχνίδι ή η σελίδα σας χρησιμοποιεί γι' αυτόν για 15 λεπτά. Το πρώτο token για ένα player_ref δημιουργεί έναν μαθητή για αυτόν τον παίκτη· τα επόμενα τον ξαναχρησιμοποιούν. Ζητήστε νέο όταν λήξει το token· δεν ανανεώνεται ποτέ. Απαιτεί πελάτη metered.

Εύρη δικαιωμάτων embed:mint

Παράμετροι

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

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

player_refstringυποχρεωτικό: Η δική σας αναφορά για τον παίκτη: 1 έως 128 byte UTF-8, χωρίς χαρακτήρες ελέγχου. Η Lingara αποθηκεύει μόνο ένα hash της.
scopesarray of string | nullπροαιρετικό
originstring | nullπροαιρετικό

Αποκρίσεις

200 Το token του παίκτη

tokenstringυποχρεωτικό
expires_atstringυποχρεωτικό
expires_inintegerυποχρεωτικό: Δευτερόλεπτα μέχρι να λήξει το token, μετρημένα από αυτή την απάντηση. Χρησιμοποιήστε το όταν δεν μπορείτε να εμπιστευτείτε το ρολόι της συσκευής.
subjectstringυποχρεωτικό
scopesarray of stringυποχρεωτικό
account_linkedbooleanυποχρεωτικό

Σφάλματα

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/embed/tokens" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"player_ref":"player-1001","scopes":["embed:play","lesson_plans:read","lesson_plans:write"],"origin":"https://game.example.com"}'

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