Délier un joueur de son compte Lingara

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

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

Met fin à la liaison d'un joueur. Dès l'appel suivant, le joueur joue de nouveau en tant qu'invité. Rien ne revient : ce que la liaison a transféré reste dans le compte de l'apprenant. Un joueur sans liaison active, ou déjà délié, répond 404 embed_link_not_found.

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 La liaison a pris fin

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/link" \
  -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.