Tuma tukio

Toleo la API 2026-10-affable-towhee

post https://api.getlingara.com/v1/events

Huiambia Lingara kilichotokea kwenye mchezo wako, kama vile mwanafunzi kuingia mahali papya. Tukio hurekodiwa mara moja na kujibiwa kwa 202. Kwa generate: true Lingara pia huanzisha mpango wa somo, unaohitaji lesson_plans:write na wenye mipaka na malipo kama POST /v1/lesson-plans: reaction hutaja mpango, kisha lesson_plan.ready au lesson_plan.failed hufuata. Eleza ulimwengu, kamwe usitume jina au gumzo la mchezaji.

Wigo events:write

Vigezo

Lingara-Versionheaderstringsi lazima: Toleo la API la kutumia kujibu ombi hili. Bila hilo, tokeni ya ufikiaji hupata toleo ambalo mteja wake ameunganishwa nalo, na ombi lisilo na tokeni hupata toleo la sasa. Toleo ambalo bado linaendelezwa linafikiwa tu kwa kulitaja hapa. Toleo lisilojulikana hujibiwa 400 pamoja na msimbo api_version_unknown. GET /v1/versions huorodhesha matoleo.
Idempotency-Keyheaderstringinahitajika: Thamani unayochagua kwa kila tukio na kuitumia tena unapojaribu upya: herufi 1 hadi 255 za ASCII zinazoonekana, kama UUID. Jaribio jipya kwa ufunguo ule ule hupata jibu la kwanza na halitozwi tena, hata kama maudhui yake ni tofauti. Bila ufunguo halali, ombi hujibu 400 kwa msimbo idempotency_key_required.

Mwili wa ombi `application/json`

typestringinahitajika

dataWorldPracticeRequestedinahitajika

topicstringinahitajika
source_langstringinahitajika
target_langstringinahitajika
levelintegerinahitajika
tagsarray of stringsi lazima
generateboolean | nullsi lazima

Majibu

202 Tukio limerekodiwa

idstringinahitajika

typestringinahitajika

created_atstringinahitajika

reactionReactionReport | nullsi lazima

statusReactionStatusinahitajika
plan_idstring | nullsi lazima
plan_statusPlanStatus | nullsi lazima: Hali ya mpango tukio lilipokubaliwa. Ni generating pekee inayoahidi kwamba lesson_plan.ready au lesson_plan.failed itafuata. Thamani nyingine yoyote ni mpango kutoka maktaba, ambao unaweza kuusoma sasa kwa GET /v1/lesson-plans/{id}.
codestring | nullsi lazima
errorstring | nullsi lazima

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

Mfano

curl -X POST "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"world.context_changed","data":{"scene":"A night market in Taipei, just after rain","npc":{"name":"Auntie Lin","persona":"a street-food vendor who likes to haggle"},"source_lang":"en","target_lang":"zh","level":3,"tags":["market","food","chapter-2"],"generate":true}}'

Unapendelea maktaba? Tazama sehemu ya Maktaba.