usage.threshold_reached

Versión de la API 2026-10-affable-towhee

Lingara → tú usage.threshold_reached

Una cuenta o un cliente con facturación por uso ha consumido una parte de su límite de gasto mensual. Solo se notifica el umbral más alto superado, así que un uso que salta del 40 % al 95 % envía un único evento con threshold_pct 90. Una integración facturada con cargo a una cuota nunca lo recibe.

Ámbitos events:readusage:read

Vías de transporte Webhook FeedGET /v1/events FlujoGET /v1/events/stream

Carga útil

idstringobligatorio

typestringobligatorio

created_atstringobligatorio

api_versionstringobligatorio

subjectstringobligatorio

dataUsageThresholdReachedDataobligatorio

scopeThresholdScopeobligatorio

threshold_pctintegerobligatorio

monthstringobligatorio

client_idstring | nullopcional

Ejemplo

{
  "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"
  }
}

Si una traducción y la referencia en inglés difieren, prevalece la referencia en inglés.