Διαγραφή παίκτη
Έκδοση API 2026-10-virile-dragon
delete https://api.getlingara.com/v1/embed/players/{player_ref}
Διαγράφει έναν από τους παίκτες σας και ό,τι δημιούργησε: τα πλάνα του, τα συμβάντα του και τα ενεργά του tokens. Ασφαλές να επαναληφθεί: ένα άγνωστο player_ref απαντά επίσης 204.
Εύρη δικαιωμάτων 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" \
-H "Authorization: Bearer $LINGARA_TOKEN"Αν μια μετάφραση διαφέρει από την αγγλική τεκμηρίωση, ισχύει η αγγλική τεκμηρίωση.