Magpadala ng event

Bersyon ng API 2026-10-affable-towhee

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

Sinasabi sa Lingara kung ano ang nangyari sa iyong laro, gaya ng pagpasok ng nag-aaral sa bagong lugar. Isang beses itinatala ang event at sinasagot ng 202. Kapag may generate: true, magsisimula rin ang Lingara ng lesson plan, na nangangailangan ng lesson_plans:write at may parehong limitasyon at singil gaya ng POST /v1/lesson-plans: pinangangalanan ng reaction ang plan, at susunod ang lesson_plan.ready o lesson_plan.failed. Ilarawan ang mundo, huwag kailanman ang pangalan o chat ng isang manlalaro.

Mga scope events:write

Mga parameter

Lingara-Versionheaderstringopsyonal: Ang bersyon ng API na gagamitin sa pagsagot sa kahilingang ito. Kung wala ito, makukuha ng access token ang bersyong naka-pin sa client nito, at makukuha ng kahilingang walang token ang kasalukuyang bersyon. Maaabot lang ang bersyong dine-develop pa sa pamamagitan ng pagpangalan dito. Ang hindi kilalang bersyon ay sinasagot ng 400 na may code na api_version_unknown. Inililista ng GET /v1/versions ang mga bersyon.
Idempotency-Keyheaderstringkailangan: Isang value na pinipili mo para sa bawat event at muling ginagamit kapag inuulit mo ito: 1 hanggang 255 na nakikitang ASCII character, gaya ng UUID. Ang pag-uulit na may parehong key ay makakatanggap ng unang sagot at hindi na muling sisingilin, kahit iba ang laman nito. Kung walang valid na key, sasagot ang request ng 400 na may code na idempotency_key_required.

Katawan ng kahilingan `application/json`

typestringkailangan

dataWorldPracticeRequestedkailangan

topicstringkailangan
source_langstringkailangan
target_langstringkailangan
levelintegerkailangan
tagsarray of stringopsyonal
generateboolean | nullopsyonal

Mga tugon

202 Naitala ang event

idstringkailangan

typestringkailangan

created_atstringkailangan

reactionReactionReport | nullopsyonal

statusReactionStatuskailangan
plan_idstring | nullopsyonal
plan_statusPlanStatus | nullopsyonal: Ang status ng plan nang tanggapin ang event. Ang generating lamang ang nangangakong susunod ang lesson_plan.ready o lesson_plan.failed. Ang anumang ibang value ay plan mula sa library, na mababasa mo na ngayon gamit ang GET /v1/lesson-plans/{id}.
codestring | nullopsyonal
errorstring | nullopsyonal

Mga error

402application/json: Tinanggihan ang tawag ng isang metered client bago ito nakagastos ng anuman. spend_cap_reached: naabot na ng client o ng account nito ang buwanang limitasyon sa paggastos; itaas ang limitasyon sa pahinang Mga integration. metered_billing_inactive: hindi aktibo ang usage billing para sa account na ito; i-set up ito, o i-update ang paraan ng pagbabayad, sa pahinang Mga integration.
410application/json: Itinigil na ang bersyon ng API na ginagamit sa pagsagot sa kahilingang ito. Magpadala ng suportadong bersyon sa Lingara-Version, o i-pin ang client sa ibang bersyon.
4XXapplication/json: Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.
503application/json · text/plain: Pansamantalang hindi available ang serbisyo; subukang muli pagkatapos ng bilang ng segundong nasa Retry-After. Habang may maintenance, plain text ang body sa halip na ang error envelope.
5XXapplication/json: Tinanggihan ang kahilingan. Sinasabi ng code kung bakit, at ipinapaliwanag ito ng error sa mga salita.

codestringkailangan: Kung bakit tinanggihan ang request, bilang isang matatag na code na mapagbabatayan ng iyong programa: halimbawa insufficient_scope (403), rate_limited (429) at, para sa isang metered client, spend_cap_reached (402) at metered_billing_inactive (402).
errorstringkailangan

Halimbawa

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}}'

Mas gusto ang library? Tingnan ang seksyong Mga library.