لوبغاړی د هغه له Lingara حساب سره ونښلوئ

د API نسخه 2026-10-virile-dragon

put https://api.getlingara.com/v1/embed/players/{player_ref}/link

ستاسو یو لوبغاړی له هغه Lingara حساب سره نښلوي چې همدا اوس یې ستاسو اپلیکېشن ته لاسرسی ورکړ. دا د هغه استازي ټوکن سره راوبولئ چې ستاسو سرور د هغه حساب لپاره ترلاسه کړی، هېڅکله د خپل پېرېدونکي له خپل ټوکن سره نه. له هغې وروسته د لوبغاړي ټوکنونه د حساب په توګه عمل کوي، تر هغه حده چې اجازه ورکوي: events:read وغواړئ، که نه نو له نښلولو وروسته به د لوبغاړي په اړه هېڅ وانه ورئ. بشپړ شوي پلانونه حساب ته لېږدول کېږي؛ هغه پلان چې لا لیکل کېږي تر هغه پاتې کېږي چې بیا یې راوبولئ. تکرار یې خوندي دی: تکرار existing ځواب ورکوي او هغه څه لېږدوي چې مخکې نه شول لېږدول. نښلول تاسو ته هېڅ لګښت نه لري.

ساحې embed:play

پیرامیټرونه

Lingara-Versionheaderstringاختیاري: د API هغه نسخه چې دې غوښتنې ته پرې ځواب ورکول کېږي. له دې پرته، لاسرسي ټوکن هغه نسخه ترلاسه کوي چې د هغه کلاینټ ورسره تړل شوی، او بې ټوکنه غوښتنه اوسنۍ نسخه ترلاسه کوي. هغې نسخې ته چې لا هم د پراختیا په حال کې ده یوازې دلته د هغې په نومولو رسېدای شئ. نامعلومې نسخې ته د 400 او کوډ api_version_unknown سره ځواب ورکول کېږي. GET /v1/versions نسخې لېست کوي.
player_refpathstringاړین: هغه player_ref چې تاسو پرې د لوبغاړي ټوکنونه صادر کړي، په سلنه‌يي کوډ: guild/42 کېږي guild%2F42.

ځوابونه

200 د لوبغاړي نښلول

statusLinkStatusاړین
subjectstringاړین: د حساب lgr_sub_: هغه څه چې د دې لوبغاړي پېښې له اوس وروسته ورسره لري.
previous_subjectstringاړین: د مېلمه lgr_sub_: هغه څه چې د لوبغاړي پخوانۍ پېښې ساتي. دواړه یو player_ref ته ولېږئ.
linked_atstringاړین: کله چې نښلول جوړ شول. په existing ځواب کې، د لومړۍ بلنې وخت.
scopesarray of stringاړین: تر ټولو ډېر هغه څه چې د دې لوبغاړي ټوکن اوس لرلی شي: هغه څه چې حساب اجازه ورکړې، له هغو ساحو څخه چې د لوبغاړي ټوکن یې لرلی شي.
carriedobjectاړین: هغه کرښې چې دې بلنې حساب ته لېږدولې، د جدول له مخې. یوازې هغه جدولونه ښکاري چې شمېر لري.
keptobjectاړین: هغه کرښې چې دې بلنې له مېلمه سره پرېښودې، د جدول له مخې: یو پلان چې لا لیکل کېږي، یا یوه کرښه چې حساب لا دمخه درلوده. کله چې دلته lesson_plans بشپړ شوی پلان ولري، بیا یې راوبولئ.

تېروتنې

402application/json: د کارونې له مخې بیل کېدونکي پېرودونکي غوښتنه مخکې له دې چې څه ولګوي رد شوه. spend_cap_reached: پېرودونکی یا د هغه حساب خپلې میاشتنۍ لګښت پولې ته رسېدلی؛ پوله د یوځای کېدنو په پاڼه کې لوړه کړئ. metered_billing_inactive: د دې حساب لپاره د کارونې له مخې بیل فعال نه دی؛ هغه د یوځای کېدنو په پاڼه کې تنظیم کړئ یا د تادیې طریقه تازه کړئ.
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 PUT "https://api.getlingara.com/v1/embed/players/$PLAYER_REF/link" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

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

که یوه ژباړه له انګلیسي مرجع سره توپیر ولري، انګلیسي مرجع سمه ده.