د Lingara API مرجع

د API نسخه 2026-10-affable-towhee

په هغو ژبو چې Lingara یې ښیي، د لغتونو لیستونه او د درس پلانونه جوړ کړئ او له ښوونکي سره خبرې وکړئ. د هرې غوښتنې لګښت هغه پیرودونکی ورکوي چې غوښتنه کوي: د allowance پیرودونکی د خپل مالک له ونډې لګوي، او د metered پیرودونکي ته د هغه د کارونې بل ورکول کېږي.

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

اساسي URL https://api.getlingara.com

د OAuth 2.0 یو لاسرسي ټوکن، چې د Authorization: Bearer <token> په بڼه لېږل کېږي. یو سرور چې د ځان په استازیتوب کار کوي د خپل کلاینټ پېژند او پټ کلید د ټوکن په پته کې بدلوي (client_credentials). یو اپ چې د Lingara د داسې کارن په استازیتوب کار کوي چې رضایت ورکوي د اجازې کوډ (authorization_code) کاروي او بیا ټوکن تازه کوي. یو ټوکن یو ساعت دوام کوي. هر عملیات یوې ساحې ته اړتیا لري.

د ټوکن URL https://api.getlingara.com/oauth/token

ساحې
`vocab:generate`	د لغتونو لیستونه جوړول.	د لغتونو لیست جوړول
`lesson_plans:read`	خپل د درس پلانونه لوستل او د هغوی پرمختګ ته بیا وصلېدل.	د درس پلان ترلاسه کول د درس پلان ته بیا وصلېدل
`lesson_plans:write`	د درس پلانونه جوړول.	د درس پلان جوړول
`tutor:converse`	له ښوونکي سره خبرې کول. پیسې لرونکي پلان ته اړتیا لري.	ښوونکي ته یو وار لېږل
`usage:read`	خپله پاتې ونډه لیدل، یا د `metered` پیرودونکي د دې میاشتې کارونه.	خپله پاتې ونډه ترلاسه کړئ
`events:read`	ستاسو د حساب په اړه پېښې لوستل، او د هغو پای ټکو ثبتول چې دا پېښې ترلاسه کوي.	د پېښو لړلیک د پېښو جریان
`events:write`	له خپلې لوبې یا یوځای کېدنې څخه Lingara ته پېښې لېږل.	پېښه واستوئ

تېروتنې

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اړین

لغتونه

د زده کوونکي د کچې سره سم د لغتونو لیستونه جوړ کړئ.

د لغتونو لیست جوړول POST /v1/vocab/stream

د درس پلانونه

د درس پلانونه جوړ کړئ، ولولئ یې، او هغه پلان ته بیا وصل شئ چې لا جوړېږي.

د درس پلان جوړول POST /v1/lesson-plans
د درس پلان ترلاسه کول GET /v1/lesson-plans/{id}
د درس پلان ته بیا وصلېدل GET /v1/lesson-plans/{id}/stream

ښوونکی

له ژبې ښوونکي سره یو یو وار خبرې وکړئ.

ښوونکي ته یو وار لېږل POST /v1/tutor/message

پېښې

هغه پېښې ولولئ چې ستاسو په حساب کې کېږي، پاڼه په پاڼه یا د جریان په توګه.

د پېښو لړلیک GET /v1/events
پېښه واستوئ POST /v1/events
د پېښو جریان GET /v1/events/stream

حساب

وګورئ چې ستاسو له ونډې څومره پاتې ده.

خپله پاتې ونډه ترلاسه کړئ GET /v1/usage

مرجع

همدا سند، د ماشین لپاره د لوستلو وړ بڼه کې.

همدا سند ترلاسه کول GET /v1/openapi.json
د پېښو سند ترلاسه کول GET /v1/asyncapi.json
د API نسخو لېست GET /v1/versions
د API یوه نسخه ترلاسه کړئ GET /v1/versions/{id}

د پېښو لېست

Lingara هغه څه چې ستاسو د حساب د لوست پلانونو او کارونې سره پېښېږي د پېښو په توګه ثبتوي، او ستاسو له لوبې یا اپ څخه پېښې مني. هره پېښه، په هره لاره چې ولاړه شي، یو شان لفافه لري، او د پېښو لېست ټولې یې شمېري. ویب‌هوکونه او پېښې

Lingara ← تاسو lesson_plan.ready
Lingara ← تاسو lesson_plan.failed
Lingara ← تاسو usage.threshold_reached
Lingara ← تاسو webhook.test
Lingara ← تاسو app.installed
Lingara ← تاسو app.uninstalled

تاسو ← Lingara world.context_changed
تاسو ← Lingara world.practice_requested

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