Bûyerekê bişîne

Guhertoya API 2026-10-affable-towhee

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

Ji Lingara re dibêje di lîstika te de çi qewimî, wek ku fêrxwaz dikeve cihekî nû. Bûyer carekê tê tomarkirin û bi 202 tê bersivandin. Bi generate: true Lingara plansaziyeke dersê jî dide destpêkirin, ku lesson_plans:write pêwîst e û wek POST /v1/lesson-plans tê sînorkirin û fature kirin: reaction navê plansaziyê dide, û paşê lesson_plan.ready an lesson_plan.failed tê. Cîhanê binivîse, qet navê lîstikvanekî an axaftina wî nenivîse.

Scope events:write

Parametre

Lingara-Versionheaderstringvebijarkî: Guhertoya API ya ku ev daxwaz pê tê bersivandin. Bêyî wê, tokena gihîştinê guhertoya ku klientê wê pê ve girêdayî ye distîne, û daxwazeke bê token guhertoya niha distîne. Guhertoya ku hîn di pêşxistinê de ye tenê bi binavkirina wê li vir tê gihîştin. Guhertoyeke nenas bi 400 û koda api_version_unknown tê bersivandin. GET /v1/versions guhertoyan rêz dike.
Idempotency-Keyheaderstringpêwîst: Nirxek ku tu ji bo her bûyerê hildibijêrî û dema ku tu dîsa diceribînî dîsa bi kar tînî: 1 heta 255 tîpên ASCII yên xuya, wek UUID. Ceribandina dîsa bi heman mifteyê bersiva yekem distîne û careke din nayê fature kirin, her çend naveroka wê cuda be jî. Bê mifteyeke derbasdar, daxwaz bi 400 û koda idempotency_key_required bersiv dide.

Naveroka daxwazê `application/json`

typestringpêwîst

dataWorldPracticeRequestedpêwîst

topicstringpêwîst
source_langstringpêwîst
target_langstringpêwîst
levelintegerpêwîst
tagsarray of stringvebijarkî
generateboolean | nullvebijarkî

Bersiv

202 Bûyer hat tomarkirin

idstringpêwîst

typestringpêwîst

created_atstringpêwîst

reactionReactionReport | nullvebijarkî

statusReactionStatuspêwîst
plan_idstring | nullvebijarkî
plan_statusPlanStatus | nullvebijarkî: Rewşa plansaziyê dema ku bûyer hat qebûlkirin. Tenê generating soz dide ku lesson_plan.ready an lesson_plan.failed dê bê. Her nirxeke din plansaziyek e ku ji pirtûkxaneyê hatiye pêşkêşkirin, ku tu dikarî niha bi GET /v1/lesson-plans/{id} bixwînî.
codestring | nullvebijarkî
errorstring | nullvebijarkî

Çewtî

402application/json: Bangeke klienteke pîvandî hat redkirin berî ku tiştek xerc bike. spend_cap_reached: klient an hesabê wê gihîştiye sînorê xercê yê mehane; sînor li rûpela Entegrasyon bilind bike. metered_billing_inactive: fatûrekirina li gorî bikaranînê ji bo vî hesabî ne çalak e; wê li rûpela Entegrasyon saz bike an rêbaza dayînê nû bike.
410application/json: Guhertoya API ya ku ev daxwaz pê tê bersivandin hate rawestandin. Guhertoyeke piştgirîkirî di Lingara-Version de bişîne, an klientê bi guhertoyeke din ve girê bide.
4XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.
503application/json · text/plain: Xizmet bi demkî ne berdest e; piştî hejmara çirkeyên di Retry-After de dîsa biceribîne. Di dema lênêrînê de naverok nivîsa sade ye, ne zerfa çewtiyê.
5XXapplication/json: Daxwaz hate redkirin. code sedemê dibêje, û error wê bi gotinan dibêje.

codestringpêwîst: Çima daxwaz hat redkirin, wek kodeke domdar ku mirov li gorî wê şax dike: bo nimûne insufficient_scope (403), rate_limited (429) û, ji bo klienteke pîvandî, spend_cap_reached (402) û metered_billing_inactive (402).
errorstringpêwîst

Mînak

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

Pirtûkxaneyek tercîh dikî? Beşa Pirtûkxaneyan bibîne.