Ein Token für einen Spieler ausstellen

API-Version 2026-10-virile-dragon

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

Bürgt für einen deiner Spieler und gibt ein Token zurück, das dein Spiel oder deine Seite 15 Minuten lang für ihn verwendet. Das erste Token für eine player_ref legt einen Lernenden für diesen Spieler an; spätere verwenden ihn wieder. Fordere ein neues an, wenn das Token abläuft; es wird nie erneuert. Erfordert einen metered-Client.

Scopes embed:mint

Parameter

Lingara-Versionheaderstringoptional: Die API-Version, unter der diese Anfrage beantwortet wird. Ohne sie erhält ein Zugriffstoken die Version, an die sein Client gebunden ist, und eine Anfrage ohne Token die aktuelle Version. Die Version in Entwicklung ist nur erreichbar, indem man sie hier nennt. Eine unbekannte Version wird mit 400 und dem Code api_version_unknown beantwortet. GET /v1/versions listet die Versionen auf.

Anfragetext `application/json`

player_refstringerforderlich: Deine eigene Referenz für den Spieler: 1 bis 128 Byte UTF-8, ohne Steuerzeichen. Lingara speichert nur einen Hash davon.
scopesarray of string | nulloptional
originstring | nulloptional

Antworten

200 Das Token des Spielers

tokenstringerforderlich
expires_atstringerforderlich
expires_inintegererforderlich: Sekunden bis zum Ablauf des Tokens, ab dieser Antwort gezählt. Verwende den Wert, wenn der Uhr des Geräts nicht zu trauen ist.
subjectstringerforderlich
scopesarray of stringerforderlich
account_linkedbooleanerforderlich

Fehler

410application/json: Die API-Version, unter der diese Anfrage beantwortet wird, wurde eingestellt. Sende eine unterstützte Version in Lingara-Version oder binde den Client an eine andere Version.
4XXapplication/json: Die Anfrage wurde abgelehnt. code nennt den Grund, und error beschreibt ihn in Worten.
503application/json · text/plain: Der Dienst ist vorübergehend nicht verfügbar; versuche es nach der in Retry-After angegebenen Anzahl Sekunden erneut. Während Wartungsarbeiten ist der Body reiner Text statt des Fehlerumschlags.
5XXapplication/json: Die Anfrage wurde abgelehnt. code nennt den Grund, und error beschreibt ihn in Worten.

codestringerforderlich: Warum die Anfrage abgelehnt wurde, als stabiler Code, nach dem du verzweigen kannst: zum Beispiel insufficient_scope (403), rate_limited (429) und, bei einem nutzungsbasiert abgerechneten Client, spend_cap_reached (402) und metered_billing_inactive (402).
errorstringerforderlich

Beispiel

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"}'

Lieber eine Bibliothek? Siehe den Bereich Bibliotheken.