Émettre un jeton pour un joueur

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

post https://api.getlingara.com/v1/embed/tokens

Se porte garant de l'un de vos joueurs et renvoie un jeton que votre jeu ou votre page utilise pour lui pendant 15 minutes. Le premier jeton pour un player_ref crée un apprenant pour ce joueur ; les suivants le réutilisent. Demandez-en un nouveau quand le jeton expire ; il n'est jamais renouvelé. Nécessite un client metered.

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.

Corps de la requête `application/json`

player_refstringobligatoire: Votre propre référence pour le joueur : de 1 à 128 octets UTF-8, sans caractère de contrôle. Lingara n'en conserve qu'un hachage.
scopesarray of string | nullfacultatif
originstring | nullfacultatif

Réponses

200 Le jeton du joueur

tokenstringobligatoire
expires_atstringobligatoire
expires_inintegerobligatoire: Secondes avant l'expiration du jeton, comptées à partir de cette réponse. Utilisez-la quand l'horloge de l'appareil n'est pas fiable.
subjectstringobligatoire
scopesarray of stringobligatoire
account_linkedbooleanobligatoire

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 POST "https://api.getlingara.com/v1/embed/tokens" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"player_ref":"player-1001","scopes":["embed:play","lesson_plans:read","lesson_plans:write"],"origin":"https://game.example.com"}'

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