Een token voor een speler uitgeven

API-versie 2026-10-virile-dragon

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

Staat in voor een van je spelers en geeft een token terug dat je game of pagina 15 minuten lang voor die speler gebruikt. Het eerste token voor een player_ref maakt een leerling voor die speler aan; latere tokens hergebruiken die. Vraag een nieuw aan als het token verloopt; het wordt nooit vernieuwd. Vereist een metered-client.

Bevoegdheden embed:mint

Parameters

Lingara-Versionheaderstringoptioneel: De API-versie waaronder dit verzoek wordt beantwoord. Zonder deze krijgt een toegangstoken de versie waaraan zijn client is gekoppeld, en een verzoek zonder token de huidige versie. De versie die nog in ontwikkeling is, bereik je alleen door die hier te noemen. Een onbekende versie geeft 400 met code api_version_unknown. GET /v1/versions toont de versies.

Request-body `application/json`

player_refstringverplicht: Je eigen referentie voor de speler: 1 tot 128 bytes UTF-8, zonder stuurtekens. Lingara bewaart er alleen een hash van.
scopesarray of string | nulloptioneel
originstring | nulloptioneel

Antwoorden

200 Het token van de speler

tokenstringverplicht
expires_atstringverplicht
expires_inintegerverplicht: Seconden tot het token verloopt, gerekend vanaf dit antwoord. Gebruik dit als de klok van het apparaat niet te vertrouwen is.
subjectstringverplicht
scopesarray of stringverplicht
account_linkedbooleanverplicht

Fouten

410application/json: De API-versie waaronder dit verzoek wordt beantwoord, is stopgezet. Stuur een ondersteunde versie mee in Lingara-Version, of koppel de client aan een andere versie.
4XXapplication/json: Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.
503application/json · text/plain: De dienst is tijdelijk niet beschikbaar; probeer het opnieuw na het aantal seconden in Retry-After. Tijdens onderhoud is de body platte tekst in plaats van de foutenvelop.
5XXapplication/json: Het verzoek is geweigerd. code geeft de reden aan en error beschrijft die in woorden.

codestringverplicht: Waarom het verzoek is geweigerd, als stabiele code om op te vertakken: bijvoorbeeld insufficient_scope (403), rate_limited (429) en, voor een client met verbruiksafrekening, spend_cap_reached (402) en metered_billing_inactive (402).
errorstringverplicht

Voorbeeld

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

Liever een bibliotheek? Zie de sectie Bibliotheken.