---

title: "Nutzungslimits & Warnungen" description: "Wie Zenovay die Nutzung gegen Ihren Plan verfolgt und Sie bei 80% / 95% benachrichtigt, damit Sie Ihr Limit nicht unerwartet erreichen."

Nutzungslimits & Warnungen

Jeder bezahlte Zenovay-Plan hat drei Pay-as-you-go (PAYG)-Ressourcen, die monatlich verfolgt werden:

Wenn Sie 80% einer dieser Ressourcen überschreiten, zeigt das Dashboard eine einmalige Toast-Benachrichtigung. Eine zweite Toast wird bei 95% ausgelöst. Nachdem die Warnung für den Zeitraum gezeigt wurde, wird sie erst wieder am ersten Tag des nächsten Kalendermonats (UTC) ausgelöst.

Aktuelle Nutzung lesen

GET /api/billing/usage
Authorization: Bearer ZV_xxx

Liefert die aktuelle Nutzung mit Limits und Prozent:

{
  "success": true,
  "data": {
    "websites": { "used": 2, "limit": 5, "percentage": 40 },
    "visitors": { "used": 18234, "limit": 100000, "percentage": 18 },
    "tier": { "name": "Pro 100K", "price": 35, "features": ["..."] },
    "period": {
      "start": "2026-04-01T00:00:00.000Z",
      "end":   "2026-04-30T00:00:00.000Z"
    }
  }
}

Auslesen, welche Warnungen bereits ausgelöst wurden

GET /api/billing/usage-warnings?teamId=<team-uuid>
Authorization: Bearer ZV_xxx

{
  "success": true,
  "data": {
    "billing_period_start": "2026-04-01",
    "warnings_shown": {
      "events":       [80],
      "apiEvents":    [],
      "proxyEvents":  []
    }
  }
}

warnings_shown ist nach Ressource indexiert. Das Array enthält die Prozentschwellen (80 und/oder 95), die in diesem Abrechnungszeitraum bereits ausgelöst wurden.

Eine Warnung programmatisch bestätigen

Das Dashboard erledigt das automatisch, wenn ein Toast angezeigt wird. Wenn Sie ein eigenes UI bauen, können Sie es selbst posten:

POST /api/billing/usage-warning-acknowledge
Authorization: Bearer ZV_xxx
Content-Type: application/json

{ "teamId": "<uuid>", "resource": "events", "threshold": 80 }

Der Endpoint ist idempotent — wenn die Kombination (team, period, resource, threshold) bereits eingetragen ist, erhalten Sie weiterhin ein 200 OK.

Was bei 100% passiert

Kunden-Lesematerial

• Hilfe: Nutzungslimit-Warnungen
• Hilfe: Ereignislimit-Überschreitung
• Hilfe: PAYG-Preise