Lingara Lingara Τεκμηρίωση Οδηγοί API Βιβλιοθήκες Εφαρμογές Δημιουργία Ενσωμάτωση Διαδικτυακή εφαρμογή
Γλώσσα: Ελληνικά

Αποσύνδεση παίκτη από τον λογαριασμό του στο Lingara

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

delete https://api.getlingara.com/v1/embed/players/{player_ref}/link

Τερματίζει τη σύνδεση ενός παίκτη. Από την επόμενη κλήση ο παίκτης παίζει ξανά ως επισκέπτης σας. Τίποτα δεν επιστρέφει: ό,τι μετέφερε η σύνδεση μένει στον λογαριασμό του μαθητή. Ένας παίκτης χωρίς ενεργή σύνδεση, ή ήδη αποσυνδεδεμένος, απαντά 404 embed_link_not_found.

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

Παράμετροι

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

Αποκρίσεις

204 Η σύνδεση τερματίστηκε

Σφάλματα

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 DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

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

Αν μια μετάφραση διαφέρει από την αγγλική τεκμηρίωση, ισχύει η αγγλική τεκμηρίωση.