Quotas

L'endpoint /v1/quotas montre trois choses :

1. Les limites du tier de base (Free / Pro / IllimitéAPI / Enterprise) — ce que votre abonnement achète.
2. Tout override par boutique défini par le support (deals custom, intégrations partenaires).
3. Les limites effectives — l'override l'emporte, défaut au tier sinon.

GET /v1/quotas

Auth : clé plateforme avec usage:read.

Requête

curl https://api.dzbuild.app/v1/quotas \
  -H "Authorization: Bearer $DZ_KEY"

Réponse 200

{
  "data": {
    "tier": "pro_plus",
    "tier_limits": {
      "requests_per_month":  5000000,
      "signups_per_month":   50000,
      "webhooks_per_month":  500000,
      "requests_per_minute": 1200
    },
    "overrides": null,
    "effective": {
      "requests_per_month":  5000000,
      "signups_per_month":   50000,
      "webhooks_per_month":  500000,
      "requests_per_minute": 1200
    }
  }
}

Lorsqu'un override est en place :

{
  "data": {
    "tier": "pro",
    "tier_limits": {
      "requests_per_month":  500000,
      "signups_per_month":   5000,
      "webhooks_per_month":  50000,
      "requests_per_minute": 300
    },
    "overrides": {
      "requests_per_month":  2000000,
      "signups_per_month":   null,
      "webhooks_per_month":  null,
      "requests_per_minute": 600,
      "notes": "Partner integration — Q2 2026"
    },
    "effective": {
      "requests_per_month":  2000000,
      "signups_per_month":   5000,
      "webhooks_per_month":  50000,
      "requests_per_minute": 600
    }
  }
}

Quand demander un override

• Pic saisonnier sans upgrader le mois entier (Aïd, Black Friday).
• Intégration partenaire — un service type Zapier se connecte pour vous et a besoin d'un RPS plus haut.
• Contrat custom — deals Enterprise.

Contactez le support avec votre store id pour en mettre un en place. Les overrides sont marchand-friendly : ils ne font que lever des plafonds, jamais les baisser.

-1 = illimité

Tout champ à -1 signifie pas de limite. Le tier Enterprise met les quatre champs à -1 par défaut. Un cap dur requests_per_minute reste actif pour protéger la plateforme — 6000 pour Enterprise sauf si un débit supérieur est convenu contractuellement.

Quand vous toucherez un quota

• Burst par minute → 429 avec Retry-After.
• Quota mensuel de requêtes → 402 quota_exceeded jusqu'au 1er du mois suivant.
• Quota d'inscriptions → même forme 402, mais ne bloque que /v1/signups. Les autres endpoints continuent.
• Quota de livraison de webhooks → les webhooks sortants pausent jusqu'au reset ; l'API entrante fonctionne normalement.

Voir Erreurs et Limites de taux pour les stratégies de retry.