---

title: "Limites d'utilisation et alertes" description: "Comment Zenovay suit l'utilisation par rapport à votre plan et vous notifie à 80% / 95% pour ne pas atteindre votre limite par surprise."

Limites d'utilisation et alertes

Chaque plan Zenovay payant a trois ressources pay-as-you-go (PAYG) suivies mensuellement :

Lorsque vous dépassez 80% de l'une de ces ressources, le tableau de bord déclenche une notification toast unique. Une seconde toast se déclenche à 95%. Après l'affichage de l'alerte pour la période, elle ne se redéclenchera pas avant le premier jour du mois calendaire suivant (UTC).

Lire l'utilisation actuelle

GET /api/billing/usage
Authorization: Bearer ZV_xxx

Renvoie l'utilisation actuelle avec les limites et le pourcentage :

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

Lire quelles alertes ont déjà été déclenchées

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 est indexé par ressource. Le tableau contient les seuils en pourcentage (80 et/ou 95) qui ont déjà été déclenchés pendant cette période de facturation.

Acquitter une alerte programmatiquement

Le tableau de bord le fait automatiquement quand un toast est affiché. Si vous construisez une UI personnalisée, vous pouvez le poster vous-même :

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

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

Le endpoint est idempotent — si la combinaison (team, period, resource, threshold) a déjà été enregistrée, vous recevez quand même un 200 OK.

Ce qui se passe à 100%

Lectures côté client

• Aide : Alertes de limite d'utilisation
• Aide : Dépassement de la limite d'événements
• Aide : Tarification PAYG