Gumawa ng token para sa manlalaro

Bersyon ng API 2026-10-virile-dragon

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

Pinananagutan ang isa sa iyong mga manlalaro at nagbabalik ng token na ginagamit ng iyong laro o pahina para sa kanila sa loob ng 15 minuto. Ang unang token para sa isang player_ref ay gumagawa ng mag-aaral para sa manlalarong iyon; ginagamit itong muli ng mga susunod. Humingi ulit kapag nag-expire ang token; hindi ito kailanman nire-refresh. Kailangan ng metered na client.

Mga scope embed:mint

Mga parameter

Lingara-Versionheaderstringopsyonal: Ang bersyon ng API na gagamitin sa pagsagot sa kahilingang ito. Kung wala ito, makukuha ng access token ang bersyong naka-pin sa client nito, at makukuha ng kahilingang walang token ang kasalukuyang bersyon. Maaabot lang ang bersyong dine-develop pa sa pamamagitan ng pagpangalan dito. Ang hindi kilalang bersyon ay sinasagot ng 400 na may code na api_version_unknown. Inililista ng GET /v1/versions ang mga bersyon.

Katawan ng kahilingan `application/json`

player_refstringkailangan: Ang sarili mong reference para sa manlalaro: 1 hanggang 128 byte ng UTF-8, walang control character. Hash lang nito ang iniimbak ng Lingara.
scopesarray of string | nullopsyonal
originstring | nullopsyonal

Mga tugon

200 Ang token ng manlalaro

tokenstringkailangan
expires_atstringkailangan
expires_inintegerkailangan: Mga segundo bago mag-expire ang token, binibilang mula sa sagot na ito. Gamitin ito kapag hindi mapagkakatiwalaan ang orasan ng device.
subjectstringkailangan
scopesarray of stringkailangan
account_linkedbooleankailangan

Mga error

410application/json: Itinigil na ang bersyon ng API na ginagamit sa pagsagot sa kahilingang ito. Magpadala ng suportadong bersyon sa Lingara-Version, o i-pin ang client sa ibang bersyon.
4XXapplication/json: Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.
503application/json · text/plain: Pansamantalang hindi available ang serbisyo; subukang muli pagkatapos ng bilang ng segundong nasa Retry-After. Habang may maintenance, plain text ang body sa halip na ang error envelope.
5XXapplication/json: Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

codestringkailangan: Kung bakit tinanggihan ang request, bilang isang matatag na code na mapagbabatayan ng iyong programa: halimbawa insufficient_scope (403), rate_limited (429) at, para sa isang metered client, spend_cap_reached (402) at metered_billing_inactive (402).
errorstringkailangan

Halimbawa

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

Mas gusto ang library? Tingnan ang seksyong Mga library.