usage.threshold_reached

API-versio 2026-10-affable-towhee

Lingara → sinä usage.threshold_reached

Käytön mukaan laskutettava tili tai asiakas on käyttänyt osan kuukausittaisesta kulutusrajastaan. Vain korkein ylitetty kynnys raportoidaan, joten käyttö, joka hyppää 40 %:sta 95 %:iin, lähettää yhden tapahtuman arvolla threshold_pct 90. Kiintiöstä laskutettava integraatio ei koskaan saa sitä.

Oikeuslaajuudet events:readusage:read

Siirtotavat Webhook SyöteGET /v1/events VirtaGET /v1/events/stream

Hyötykuorma

idstringpakollinen

typestringpakollinen

created_atstringpakollinen

api_versionstringpakollinen

subjectstringpakollinen

dataUsageThresholdReachedDatapakollinen

scopeThresholdScopepakollinen

threshold_pctintegerpakollinen

monthstringpakollinen

client_idstring | nullvalinnainen

Esimerkki

{
  "id": "lgr_evt_9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b",
  "type": "usage.threshold_reached",
  "created_at": "2026-10-01T12:00:00Z",
  "api_version": "2026-09-equipped-boxfish",
  "subject": "lgr_sub_8f445eaad6febfab1731b2f8cb17c24e",
  "data": {
    "scope": "client",
    "threshold_pct": 100,
    "month": "2026-10",
    "client_id": "lgr_cid_4hT9kQ2mZx7Lp1Vb8Nc3Rw"
  }
}

Jos käännös ja englanninkielinen viite poikkeavat toisistaan, englanninkielinen viite on oikea.