Toa tokeni kwa mchezaji

Toleo la API 2026-10-virile-dragon

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

Inamdhamini mmoja wa wachezaji wako na inarudisha tokeni ambayo mchezo au ukurasa wako unatumia kwa ajili yake kwa dakika 15. Tokeni ya kwanza kwa player_ref huunda mwanafunzi kwa mchezaji huyo; zinazofuata humtumia tena. Omba tena tokeni inapoisha muda; haifanywi upya kamwe. Inahitaji mteja wa metered.

Wigo embed:mint

Vigezo

Lingara-Versionheaderstringsi lazima: Toleo la API la kutumia kujibu ombi hili. Bila hilo, tokeni ya ufikiaji hupata toleo ambalo mteja wake ameunganishwa nalo, na ombi lisilo na tokeni hupata toleo la sasa. Toleo ambalo bado linaendelezwa linafikiwa tu kwa kulitaja hapa. Toleo lisilojulikana hujibiwa 400 pamoja na msimbo api_version_unknown. GET /v1/versions huorodhesha matoleo.

Mwili wa ombi `application/json`

player_refstringinahitajika: Rejeleo lako mwenyewe kwa mchezaji: baiti 1 hadi 128 za UTF-8, bila herufi za udhibiti. Lingara huhifadhi hashi yake tu.
scopesarray of string | nullsi lazima
originstring | nullsi lazima

Majibu

200 Tokeni ya mchezaji

tokenstringinahitajika
expires_atstringinahitajika
expires_inintegerinahitajika: Sekunde hadi tokeni iishe muda, zikihesabiwa kuanzia jibu hili. Itumie wakati saa ya kifaa haiwezi kuaminiwa.
subjectstringinahitajika
scopesarray of stringinahitajika
account_linkedbooleaninahitajika

Hitilafu

410application/json: Toleo la API linalotumika kujibu ombi hili limesitishwa. Tuma toleo linalotumika katika Lingara-Version, au unganisha mteja na toleo lingine.
4XXapplication/json: Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.
503application/json · text/plain: Huduma haipatikani kwa muda; jaribu tena baada ya idadi ya sekunde zilizo katika Retry-After. Wakati wa matengenezo, mwili wa jibu ni maandishi ya kawaida badala ya bahasha ya hitilafu.
5XXapplication/json: Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

codestringinahitajika: Sababu ya ombi kukataliwa, kama msimbo thabiti wa kufanyia maamuzi: kwa mfano insufficient_scope (403), rate_limited (429) na, kwa mteja anayetozwa kwa matumizi, spend_cap_reached (402) na metered_billing_inactive (402).
errorstringinahitajika

Mfano

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

Unapendelea maktaba? Tazama sehemu ya Maktaba.