Reik 'n token vir 'n speler uit

API-weergawe 2026-10-virile-dragon

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

Staan in vir een van jou spelers en gee 'n token terug wat jou speletjie of bladsy 15 minute lank vir hulle gebruik. Die eerste token vir 'n player_ref skep 'n leerder vir daardie speler; latere tokens gebruik dit weer. Vra weer wanneer die token verval; dit word nooit hernu nie. Benodig 'n metered-kliënt.

Omvange embed:mint

Parameters

Lingara-Versionheaderstringopsioneel: Die API-weergawe waaronder hierdie versoek beantwoord word. Daarsonder kry 'n toegangstoken die weergawe waaraan sy kliënt gekoppel is, en 'n versoek sonder 'n token kry die huidige weergawe. Die weergawe wat nog ontwikkel word, is slegs bereikbaar deur dit hier te noem. 'n Onbekende weergawe gee 400 met kode api_version_unknown. GET /v1/versions lys die weergawes.

Versoekliggaam `application/json`

player_refstringverplig: Jou eie verwysing vir die speler: 1 tot 128 grepe UTF-8, sonder beheerkarakters. Lingara stoor slegs 'n hash daarvan.
scopesarray of string | nullopsioneel
originstring | nullopsioneel

Antwoorde

200 Die speler se token

tokenstringverplig
expires_atstringverplig
expires_inintegerverplig: Sekondes totdat die token verval, getel vanaf hierdie antwoord. Gebruik dit wanneer die toestel se horlosie nie vertrou kan word nie.
subjectstringverplig
scopesarray of stringverplig
account_linkedbooleanverplig

Foute

410application/json: Die API-weergawe waaronder hierdie versoek beantwoord word, is gestaak. Stuur 'n ondersteunde weergawe in Lingara-Version, of koppel die kliënt aan 'n ander weergawe.
4XXapplication/json: Die versoek is geweier. code sê hoekom, en error sê dit in woorde.
503application/json · text/plain: Die diens is tydelik onbeskikbaar; probeer weer na die aantal sekondes in Retry-After. Tydens onderhoud is die liggaam gewone teks eerder as die foutomhulsel.
5XXapplication/json: Die versoek is geweier. code sê hoekom, en error sê dit in woorde.

codestringverplig: Waarom die versoek geweier is, as 'n stabiele kode om op te vertak: byvoorbeeld insufficient_scope (403), rate_limited (429) en, vir 'n gemeterde kliënt, spend_cap_reached (402) en metered_billing_inactive (402).
errorstringverplig

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

Verkies jy 'n biblioteek? Sien die Biblioteke-afdeling.