د لوبغاړي لپاره ټوکن صادرول

پیرامیټرونه

Lingara-Versionheaderstringاختیاري

د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي. له دې پرته، لاسرسي ټوکن هغه نسخه ترلاسه کوي چې د هغه کلاینټ ورسره تړل شوی، او بې ټوکنه غوښتنه اوسنۍ نسخه ترلاسه کوي. هغې نسخې ته چې لا هم د پراختیا په حال کې ده یوازې دلته د هغې په نومولو رسېدای شئ. نامعلومې نسخې ته د 400 او کوډ api_version_unknown سره ځواب ورکول کېږي. GET /v1/versions نسخې لېست کوي.

د غوښتنې بدنه application/json

player_refstringاړین

د لوبغاړي لپاره ستاسو خپل مرجع: له ۱ تر ۱۲۸ بایټه UTF-8، پرته له کنټرولي توري. Lingara یوازې د هغې هش ساتي.

scopesarray of string | nullاختیاري

originstring | nullاختیاري

ځوابونه

200 د لوبغاړي ټوکن

tokenstringاړین

expires_atstringاړین

expires_inintegerاړین

د ټوکن تر پای ته رسېدو پورې ثانیې، له همدې ځواب څخه شمېرل کېږي. کله یې وکاروئ چې د وسیلې پر ساعت باور نه شي کېدای.

subjectstringاړین

scopesarray of stringاړین

account_linkedbooleanاړین

تېروتنې

410application/json

د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي بنده شوې ده. په Lingara-Version کې یوه ملاتړ شوې نسخه ولېږئ، یا کلاینټ له بلې نسخې سره وتړئ.

4XXapplication/json

غوښتنه رد شوه. code لامل ښیي، او error یې په کلمو بیانوي.

503application/json · text/plain

خدمت په لنډمهاله توګه نه شته؛ د هغو ثانیو له تېرېدو وروسته بیا هڅه وکړئ چې په Retry-After کې راغلي دي. د ساتنې پر مهال، د ځواب بدنه د تېروتنې د پاکټ پر ځای ساده متن وي.

5XXapplication/json

غوښتنه رد شوه. code لامل ښیي، او error یې په کلمو بیانوي.

codestringاړین

ولې غوښتنه رد شوه، د یو ثابت کوډ په توګه چې پر بنسټ یې پرېکړه کولی شئ: د بېلګې په توګه insufficient_scope (403)، rate_limited (429) او، د کارونې له مخې بیل کېدونکي پېرودونکي لپاره، spend_cap_reached (402) او metered_billing_inactive (402).

errorstringاړین

بېلګه

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

کتابتون غوره بولئ؟ د کتابتونونو برخه وګورئ.