usage.threshold_reached

API-Version 2026-10-affable-towhee

Lingara → dich usage.threshold_reached

Ein nutzungsbasiert abgerechnetes Konto oder ein solcher Client hat einen Teil seines monatlichen Ausgabenlimits verbraucht. Gemeldet wird nur der höchste überschrittene Schwellenwert, sodass eine Nutzung, die von 40 % auf 95 % springt, ein einziges Ereignis mit threshold_pct 90 sendet. Eine über ein Kontingent abgerechnete Integration erhält es nie.

Scopes events:readusage:read

Übertragungswege Webhook FeedGET /v1/events StreamGET /v1/events/stream

Nutzdaten

idstringerforderlich

typestringerforderlich

created_atstringerforderlich

api_versionstringerforderlich

subjectstringerforderlich

dataUsageThresholdReachedDataerforderlich

scopeThresholdScopeerforderlich

threshold_pctintegererforderlich

monthstringerforderlich

client_idstring | nulloptional

Beispiel

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

Weichen eine Übersetzung und die englische Referenz voneinander ab, ist die englische Referenz maßgeblich.