Ji bo lîstikvanekî token derxe

Guhertoya API 2026-10-virile-dragon

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

Ji bo yek ji lîstikvanên te garantî dide û tokenekî vedigerîne ku lîstik an rûpela te 15 deqeyan ji bo wî bi kar tîne. Tokena yekem a player_refekê ji bo wî lîstikvanî fêrxwazekî çêdike; yên paşê wî dîsa bi kar tînin. Dema ku token biqede dîsa bixwaze; ew qet nayê nûkirin. Pêdivî bi muşteriyekî metered heye.

Scope embed:mint

Parametre

Lingara-Versionheaderstringvebijarkî: Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi 400 û koda api_version_unknown tê bersivandin. GET /v1/versions guhertoyan rêz dike.

Naveroka daxwazê `application/json`

player_refstringpêwîst: Referansa te ya xwe ji bo lîstikvan: 1 heta 128 baytên UTF-8, bê tîpên kontrolê. Lingara tenê haşa wê tomar dike.
scopesarray of string | nullvebijarkî
originstring | nullvebijarkî

Bersiv

200 Tokena lîstikvan

tokenstringpêwîst
expires_atstringpêwîst
expires_inintegerpêwîst: Çirkeyên heta ku token biqede, ji vê bersivê ve têne hejmartin. Dema ku saeta cîhazê nayê bawerkirin wê bi kar bîne.
subjectstringpêwîst
scopesarray of stringpêwîst
account_linkedbooleanpêwîst

Çewtî

410application/json: Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di Lingara-Version de bişîne, an klientê bi guhertoyeke din ve girê bide.
4XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.
503application/json · text/plain: Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di Retry-After de dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê.
5XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.

codestringpêwîst: Çima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne insufficient_scope (403), rate_limited (429) û, ji bo klienteke pîvandî, spend_cap_reached (402) û metered_billing_inactive (402).
errorstringpêwîst

Mînak

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

Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.