Supprimer un joueur

Version de l'API 2026-10-virile-dragon

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

Supprime l'un de vos joueurs et tout ce qu'il a créé : ses plans, ses événements et ses jetons valides. Peut être réessayé sans risque : un player_ref inconnu répond aussi 204.

Portées embed:mint

Paramètres

Lingara-Versionheaderstringfacultatif: La version de l'API sous laquelle traiter cette requête. Sans elle, un jeton d'accès obtient la version à laquelle son client est rattaché, et une requête sans jeton obtient la version actuelle. La version encore en développement ne s'atteint qu'en la nommant ici. Une version inconnue répond 400 avec le code api_version_unknown. GET /v1/versions liste les versions.
player_refpathstringobligatoire: Le player_ref avec lequel vous avez émis les jetons du joueur, encodé en pourcentage : guild/42 devient guild%2F42.

Réponses

204 Le joueur est supprimé

Erreurs

410application/json: La version de l'API sous laquelle cette requête est traitée a été retirée. Envoyez une version prise en charge dans Lingara-Version, ou rattachez le client à une autre version.
4XXapplication/json: La requête a été refusée. code indique pourquoi, et error l'explique en toutes lettres.
503application/json · text/plain: Le service est temporairement indisponible ; réessayez après le nombre de secondes indiqué dans Retry-After. Pendant la maintenance, le corps est du texte brut plutôt que l'enveloppe d'erreur.
5XXapplication/json: La requête a été refusée. code indique pourquoi, et error l'explique en toutes lettres.

codestringobligatoire: Pourquoi la requête a été refusée, sous forme de code stable sur lequel brancher votre logique : par exemple insufficient_scope (403), rate_limited (429) et, pour un client facturé à l'usage, spend_cap_reached (402) et metered_billing_inactive (402).
errorstringobligatoire

Exemple

curl -X DELETE "https://api.getlingara.com/v1/embed/players/$PLAYER_REF" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

Vous préférez une bibliothèque ? Consultez la section Bibliothèques.

En cas de divergence entre une traduction et la référence en anglais, la référence en anglais fait foi.