ℹ️ Info — Ces limites s'appliquent à l'API uniquement — jamais à votre boutique

Tout ce que décrit cette page compte les requêtes effectuées avec une clé API vers https://api.dzbuild.app/v1.

Votre vitrine, vos clients qui passent commande, votre tableau de bord, l'application mobile et toutes les fonctionnalités natives de la plateforme n'en sont absolument pas affectés. Ils ne consomment pas ce quota, ne sont jamais throttlés par lui, et recevoir un 429 ici n'a aucun effet sur votre boutique, qui reste ouverte et continue de prendre des commandes.

Si vous n'avez jamais créé de clé API, rien sur cette page ne vous concerne.

La limite par minute est appliquée par boutique — toutes les clés d'une même boutique partagent un seul budget, donc créer davantage de clés n'augmente jamais le plafond. Elle fonctionne sur une fenêtre fixe de 60 secondes : le compteur est remis à zéro à chaque minute d'horloge. Comme la fenêtre est fixe et non glissante, une rafale à cheval sur un changement de minute peut brièvement dépasser le plafond. Gérez les 429 de façon défensive plutôt que de caler votre cadence exactement sur la limite.

L'API est disponible uniquement sur le plan Enterprise. Les clés ne peuvent être émises que pour des boutiques Enterprise, et une clé dont la boutique quitte Enterprise — par rétrogradation ou parce que l'abonnement a expiré — reçoit 403 forbidden (« API access requires an active Enterprise plan ») à chaque appel. Il n'y a rien à réémettre : la même clé refonctionne dès que la boutique retrouve un plan Enterprise actif.

Ce plafond est dimensionné pour du vrai travail d'intégration : synchroniser un catalogue, faire tourner une application mobile ou une vitrine sur mesure, ou piloter la boutique depuis un assistant IA. Un usage normal n'en approche pas. Si une charge de travail réelle exige davantage, demandez au support une surcharge propre à la boutique plutôt que de contourner la limite.

Il n'y a pas de plafond mensuel : l'usage n'est borné que par le plafond par minute, sauf si le support a mis en place une surcharge propre à la boutique avec une allocation mensuelle explicite (voir Quotas).

Quelques endpoints font bien plus de travail par appel qu'une simple lecture : ils téléchargent et réencodent des fichiers, ou démarrent des tâches en arrière-plan. Ils portent un second budget, plus petit, par boutique, qui s'ajoute à la limite par minute ci-dessus :

Dépasser la part par minute renvoie 429 rate_limited ; dépasser la part simultanée renvoie 429 too_many_concurrent, ce qui signifie simplement « réessayez dans quelques secondes » — un appel précédent est encore en train de se terminer.

Ces budgets sont volontairement serrés. Ajouter toute la galerie photo d'un produit prend malgré tout bien moins d'une minute, et le plafond empêche une intégration de ralentir les serveurs qui font aussi tourner votre vitrine.

Le compteur mensuel s'incrémente une fois par requête authentifiée qui n'est pas servie depuis le cache — les GET servis par le cache et /v1/ping sont gratuits, et les requêtes en échec sont tout de même comptées.

Appelez GET /v1/quotas (voir Quotas) pour lire les limites actuellement enregistrées pour votre boutique, y compris toute surcharge appliquée à votre compte par le support.

Une surcharge propre à la boutique peut relever vos allocations sans changer votre plan. Si vous construisez quelque chose qui a réellement besoin d'un débit soutenu plus élevé, contactez le support en décrivant le profil de requêtes attendu.