Lier un joueur à son compte Lingara

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

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

Lie l'un de tes joueurs au compte Lingara qui vient de donner accès à ton app. Appelle-la avec le jeton délégué que ton serveur a reçu pour ce compte, jamais avec le propre jeton de ton client. Dès lors, les jetons du joueur agissent en tant que le compte, dans la limite de ce que l'autorisation permet : demande events:read, sinon tu n'entendras plus rien du joueur après la liaison. Les plans terminés passent au compte ; un plan encore en cours d'écriture reste jusqu'à ce que tu rappelles. Sans risque à répéter : une répétition répond existing et déplace ce qui ne pouvait pas l'être avant. La liaison ne te coûte rien.

Portées embed:play

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

200 La liaison du joueur

statusLinkStatusobligatoire
subjectstringobligatoire: Le lgr_sub_ du compte : ce que portent désormais les événements de ce joueur.
previous_subjectstringobligatoire: Le lgr_sub_ de l'invité : ce que conservent les événements antérieurs du joueur. Achemine les deux vers le même player_ref.
linked_atstringobligatoire: Le moment où la liaison a été créée. Sur une réponse existing, l'heure du premier appel.
scopesarray of stringobligatoire: Le maximum qu'un jeton pour ce joueur peut désormais porter : ce que le compte a accordé, parmi les portées qu'un jeton de joueur peut porter.
carriedobjectobligatoire: Lignes que cet appel a déplacées vers le compte, par table. Seules les tables ayant un décompte apparaissent.
keptobjectobligatoire: Lignes que cet appel a laissées à l'invité, par table : un plan encore en cours d'écriture, ou une ligne que le compte avait déjà. Rappelle dès que lesson_plans ici contient un plan terminé.

Erreurs

402application/json: L'appel d'un client facturé à l'usage a été refusé avant qu'il ne dépense quoi que ce soit. spend_cap_reached : le client ou son compte a atteint sa limite de dépenses mensuelle ; relevez la limite sur la page Intégrations. metered_billing_inactive : la facturation à l'usage n'est pas active pour ce compte ; configurez-la ou mettez à jour le moyen de paiement sur la page Intégrations.
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 PUT "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.