سەرچاوەی Lingara API

وەشانی API 2026-10-affable-towhee

لیستی وشە و پلانی وانە دروست بکە، و گفتوگۆ لەگەڵ مامۆستا بکە، بەو زمانانەی Lingara فێریان دەکات. هەر بانگکردنێک ئەو کڕیارە پارەکەی دەدات کە دەیکات: کڕیاری allowance لە بڕی ڕێپێدراوی خاوەنەکەی خەرج دەکات، و کڕیاری metered بەپێی بەکارهێنانەکەی پارەی لێ وەردەگیرێت.

کتێبخانەیەکت پێ باشترە؟ بەشی کتێبخانەکان ببینە.

URLی بنەڕەت https://api.getlingara.com

تۆکنێکی دەستگەیشتنی OAuth 2.0، کە وەک Authorization: Bearer <token> دەنێردرێت. سێرڤەرێک کە لە جیاتی خۆی کار دەکات ناسنامە و نهێنیی کڕیارەکەی لە URLی تۆکندا دەگۆڕێتەوە (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

ئەگەر وەرگێڕانێک و سەرچاوە ئینگلیزییەکە جیاواز بن، سەرچاوە ئینگلیزییەکە دروستە.