Comprendre les limites de taux de l’API

Pour garantir la fiabilité et les performances de notre API,  monday.com applique plusieurs limites de taux. Ces limites permettent de gérer la charge du système et d’assurer une utilisation équitable entre tous les utilisateurs. Atteindre ces limites peut entraîner des erreurs temporaires, mais les comprendre vous aidera à éviter les interruptions.

Vous trouverez des détails techniques et des exemples dans notre documentation développeur sur les limites de taux.

Types de limites de taux

1. Limite de complexité

Cela contrôle le niveau de « complexité » d’une requête. La plupart des utilisateurs n’atteindront pas cette limite, mais si c’est le cas, vous verrez une erreur :

• Message d’erreur : COMPLEXITY_BUDGET_EXHAUSTED
• Que faire ?
• Ne demandez que les données dont vous avez besoin
• Évitez les requêtes trop complexes ou fortement imbriquées
• Utilisez la pagination lorsque c’est possible

2. Limite d’appels quotidienne

Chaque compte dispose d’un plafond quotidien du nombre d’appels API :

• Message d'erreur : DAILY_LIMIT_EXCEEDED

• Que faire ?
• Optimisez votre code pour réduire les appels inutiles
• Attendez que la limite soit réinitialisée à minuit (UTC)
• Si vous disposez d’un forfait Enterprise, vous pouvez demander une augmentation via le tableau de bord d’analytique API situé dans la section Administration de monday.com.

3. Limite de taux par minute

Limite le nombre de requêtes par minute. En cas de dépassement :

• Message d'erreur : Dépassement de la limite de taux
• Que faire ?
• Réduisez la fréquence des requêtes
• Utilisez l’en-tête Retry-After pour savoir quand vous pouvez réessayer en toute sécurité.

4. Limite de concurrence

Limite le nombre d’appels API pouvant être traités simultanément.

• Message d’erreur : maxConcurrencyExceeded
• Que faire ?
• Envoyer moins de requêtes en parallèle
• Ajoutez une logique de nouvelle tentative pour attendre avant de réessayer

5. Limite IP

Limite le nombre de requêtes provenant d’une seule adresse IP sur une courte période (5 000 requêtes toutes les 10 secondes).

• Message d'erreur : IP_RATE_LIMIT_EXCEEDED
• Que faire ?
• Faites une pause avant de réessayer, comme indiqué par le champ retry_in_seconds dans la réponse d’erreur

Bonnes pratiques générales

• Toutes les requêtes - même celles qui échouent - comptent dans vos limites.
• Évitez de réessayer immédiatement après une erreur de limite de taux. Vérifiez toujours le champ retry_in_seconds dans la réponse.
• Si vous utilisez notre SDK, il respecte automatiquement les réponses de limite de taux et réessaie après le délai d’attente approprié.

Pour les développeurs, nous recommandons de consulter la documentation complète sur les limites de taux afin de comprendre comment elles s’appliquent en fonction de votre cas d’utilisation et de votre forfait.

Besoin d’aide pour optimiser votre utilisation de l’API ? Contactez notre équipe de support pour obtenir de l’aide.