Limites de débit de l’API
Afin de garantir un environnement de service optimal à tous nos utilisateurs, Vivoldi applique des limites d’appels API selon votre forfait.
Si la limite est dépassée, une erreur HTTP 429 (Too Many Requests) s’affichera. Nous vous prions de bien vouloir patienter quelques instants avant de renouveler votre requête.
Limites d’Appels API par Offre
Le tableau ci-dessous présente les limites d’appels API par minute et par heure selon chaque offre.
Le volume de requêtes disponible peut varier selon la taille du service et les modèles de trafic, et des politiques de limitation sont appliquées afin de garantir des performances API stables et fiables.
| Abonnement | Max par minute | Max par heure | API de statistiques / min | API de statistiques (simultané) |
|---|---|---|---|---|
| Gratuit | 30 | 600 | 5 % de la limite de base | — |
| Personnel | 180 | 10,000 | 5 % de la limite de base | 1 |
| Prime | 300 | 15,000 | 5 % de la limite de base | 1 |
| Entreprises | 480 | 25,000 | 5 % de la limite de base | 2 |
| Business Plus | 768 | 40,000 | 5 % de la limite de base | 2 |
| Entreprise | 1,200 | 60,000 | 5 % de la limite de base | Selon le contrat (par défaut : 3) |
Comment Gérer les Dépassements de Limites API
Si la limite d’appels API est dépassée, le serveur renvoie une réponse HTTP 429 (Too Many Requests).
Afin de garantir un fonctionnement stable et fiable du service, nous recommandons de concevoir votre logique de gestion des requêtes selon les méthodes suivantes.
1. Implémenter une Logique de Retry (Retry with Backoff)
Lorsqu’une réponse 429 est reçue, attendez un court délai avant de réessayer la requête.
Plutôt que d’envoyer des requêtes répétées à intervalles courts, l’utilisation d’une stratégie Exponential Backoff est fortement recommandée.
2. Optimiser la Fréquence des Requêtes
Si les mêmes données sont demandées de manière répétée, vous pouvez réduire les appels API inutiles grâce à des mécanismes de cache.
Pour les traitements volumineux, le traitement par lots est généralement plus efficace que l’envoi de requêtes individuelles une par une.
3. Préparer les Environnements à Fort Volume
Si votre environnement approche régulièrement des limites API, envisagez une offre supérieure ou les offres Business Plus et Enterprise avec des limites de requêtes plus flexibles.
Limites flexibles Business Plus et Enterprise
Les offres Business Plus et Enterprise utilisent un modèle de montée en charge flexible où les limites API augmentent automatiquement selon le volume mensuel de liens créés, plutôt que d’utiliser des limites fixes.
Ce fonctionnement convient parfaitement aux plateformes marketing, services e-commerce et systèmes d’entreprise gérant un grand volume de liens, tout en offrant la flexibilité nécessaire pour les environnements à fort trafic.
- Base standard : 10 000 liens par mois
- Pour garantir la stabilité du service, l’extension maximale est limitée à 3,5 fois la limite de base.
Exemple (Forfait Enterprise)
- 10 000 liens/mois → 1 200 appels/min / 60 000 appels/heure
- 30 000 liens/mois → 2 000 appels/min / 100 000 appels/heure
※ Les limites d’appels Webhook correspondent à 80 % de la limite API standard.
※ Les limites réelles peuvent varier selon les termes du contrat. Pour des besoins supérieurs, veuillez nous contacter.