Marejeleo ya API ya Lingara

Toleo la API 2026-10-affable-towhee

Tengeneza orodha za msamiati na mipango ya masomo, na fanya mazungumzo na mkufunzi, katika lugha ambazo Lingara hufundisha. Kila ombi hulipiwa na mteja anayelifanya: mteja wa allowance hutumia kiwango cha matumizi cha mmiliki wake, na mteja wa metered hutozwa kwa matumizi yake.

Unapendelea maktaba? Tazama sehemu ya Maktaba.

URL ya msingi https://api.getlingara.com

Tokeni ya ufikiaji ya OAuth 2.0, inayotumwa kama Authorization: Bearer <token>. Seva inayojiwakilisha yenyewe hubadilisha kitambulisho na siri ya mteja wake kwenye URL ya tokeni (client_credentials). Programu inayomwakilisha mtumiaji wa Lingara anayetoa idhini hutumia msimbo wa uidhinishaji (authorization_code) kisha huonyesha upya. Tokeni hudumu saa moja. Kila operesheni inahitaji wigo mmoja.

URL ya tokeni https://api.getlingara.com/oauth/token

Wigo
`vocab:generate`	Kutengeneza orodha za msamiati.	Tengeneza orodha ya msamiati
`lesson_plans:read`	Kusoma mipango yako ya masomo na kuunganisha tena na maendeleo yake.	Pata mpango wa somo Unganisha tena na mpango wa somo
`lesson_plans:write`	Kuunda mipango ya masomo.	Unda mpango wa somo
`tutor:converse`	Kufanya mazungumzo na mkufunzi. Inahitaji mpango wa kulipia.	Tuma zamu kwa mkufunzi
`usage:read`	Kuona kiwango chako cha matumizi kilichobaki, au matumizi ya mwezi huu ya mteja wa `metered`.	Pata kiwango chako cha matumizi kilichobaki
`events:read`	Kusoma matukio kuhusu akaunti yako, na kusajili sehemu za mwisho zinazoyapokea.	Orodhesha matukio Tiririsha matukio
`events:write`	Kutuma matukio kutoka kwenye mchezo au muunganisho wako kwenda Lingara.	Tuma tukio

Hitilafu

402application/json: Simu ya mteja anayetozwa kwa matumizi imekataliwa kabla haijatumia chochote. spend_cap_reached: mteja au akaunti yake imefikia kikomo chake cha matumizi ya pesa cha kila mwezi; ongeza kikomo kwenye ukurasa wa Miunganisho. metered_billing_inactive: utozaji kwa matumizi haujawashwa kwa akaunti hii; uweke, au usasishe njia ya malipo, kwenye ukurasa wa Miunganisho.
410application/json: Toleo la API linalotumika kujibu ombi hili limesitishwa. Tuma toleo linalotumika katika Lingara-Version, au unganisha mteja na toleo lingine.
4XXapplication/json: Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.
503application/json · text/plain: Huduma haipatikani kwa muda; jaribu tena baada ya idadi ya sekunde zilizo katika Retry-After. Wakati wa matengenezo, mwili wa jibu ni maandishi ya kawaida badala ya bahasha ya hitilafu.
5XXapplication/json: Ombi limekataliwa. code inaeleza sababu, na error inaieleza kwa maneno.

codestringinahitajika: Sababu ya ombi kukataliwa, kama msimbo thabiti wa kufanyia maamuzi: kwa mfano insufficient_scope (403), rate_limited (429) na, kwa mteja anayetozwa kwa matumizi, spend_cap_reached (402) na metered_billing_inactive (402).
errorstringinahitajika

Msamiati

Tengeneza orodha za msamiati kulingana na kiwango cha mwanafunzi.

Tengeneza orodha ya msamiati POST /v1/vocab/stream

Mipango ya masomo

Unda mipango ya masomo, isome, na unganisha tena na mpango ambao bado unatengenezwa.

Unda mpango wa somo POST /v1/lesson-plans
Pata mpango wa somo GET /v1/lesson-plans/{id}
Unganisha tena na mpango wa somo GET /v1/lesson-plans/{id}/stream

Mkufunzi

Fanya mazungumzo na mkufunzi wa lugha, zamu moja kwa wakati.

Tuma zamu kwa mkufunzi POST /v1/tutor/message

Matukio

Soma matukio yanayotokea katika akaunti yako, ukurasa kwa ukurasa au kama mtiririko.

Orodhesha matukio GET /v1/events
Tuma tukio POST /v1/events
Tiririsha matukio GET /v1/events/stream

Akaunti

Ona kiasi cha kiwango chako cha matumizi kilichobaki.

Pata kiwango chako cha matumizi kilichobaki GET /v1/usage

Marejeleo

Hati hii, katika muundo unaosomeka na mashine.

Pata hati hii GET /v1/openapi.json
Pata hati ya matukio GET /v1/asyncapi.json
Orodhesha matoleo ya API GET /v1/versions
Pata toleo moja la API GET /v1/versions/{id}

Orodha ya matukio

Lingara hurekodi kama matukio kinachotokea kwa mipango ya masomo na matumizi ya akaunti yako, na hupokea matukio kutoka kwa mchezo au programu yako. Kila tukio, kwa njia yoyote linayosafiri, lina bahasha ileile, na orodha ya matukio inayaorodhesha yote. Webhook na matukio

Lingara → wewe lesson_plan.ready
Lingara → wewe lesson_plan.failed
Lingara → wewe usage.threshold_reached
Lingara → wewe webhook.test
Lingara → wewe app.installed
Lingara → wewe app.uninstalled

Wewe → Lingara world.context_changed
Wewe → Lingara world.practice_requested

Ikiwa tafsiri na marejeleo ya Kiingereza yanatofautiana, marejeleo ya Kiingereza ndiyo sahihi.