Skip to main content
La limitation de débit vous permet de contrôler le nombre maximum de webhooks livrés à votre endpoint par seconde. Cela protège vos systèmes contre la saturation pendant les périodes de fort trafic.

Fonctionnement

Lorsque vous définissez une limite de débit sur un endpoint :
  1. Les webhooks sont mis en file d’attente pour la livraison
  2. La livraison est régulée pour rester dans votre limite
  3. Les webhooks en excès sont retenus et livrés au fur et à mesure que la capacité se libère
Cela lisse les pics de trafic, garantissant que votre endpoint reçoit les webhooks à un rythme gérable.

Définir une limite de débit

Vous pouvez configurer la limitation de débit lors de la création ou de la modification d’un endpoint :
  1. Accédez aux paramètres Webhooks dans votre tableau de bord
  2. Cliquez sur un endpoint ou créez-en un nouveau
  3. Dans les paramètres Advanced, définissez votre Rate Limit
  4. Saisissez le nombre maximum de messages par seconde
  5. Enregistrez vos modifications

Choisir une limite de débit

Prenez en compte ces facteurs lors de la définition de votre limite :

Exemples de limites

  • Petit serveur / traitement simple : 10-50 par seconde
  • Infrastructure moyenne : 100-500 par seconde
  • Systèmes à haute capacité : 1 000+ par seconde

Considérations importantes

Accumulation de la file d’attente

Si vous recevez systématiquement plus de webhooks que votre limite de débit ne le permet, un retard va se former. Par exemple :
  • Limite de débit : 100/seconde
  • Débit entrant : 200/seconde
  • Résultat : la file d’attente grossit, augmentant les délais de livraison
Si votre volume de webhooks dépasse systématiquement votre limite de débit, les webhooks seront retardés. Surveillez votre endpoint et augmentez la limite si nécessaire.

Nouvelles tentatives et limites de débit

Les limites de débit s’appliquent à toutes les livraisons, y compris aux nouvelles tentatives. Une limite de débit basse combinée à de nombreux retries pourrait retarder les nouveaux webhooks.

Quand utiliser la limitation de débit

La limitation de débit est utile lorsque :
  • Votre endpoint a une capacité limitée - Éviter la surcharge pendant les périodes chargées
  • Le traitement est gourmand en ressources - Chaque webhook déclenche des opérations lourdes
  • Dépendances tierces - Votre gestionnaire appelle des API externes soumises à limitation de débit
  • Infrastructure partagée - Le traitement des webhooks entre en concurrence avec d’autres services
Commencez par une limite de débit conservatrice et augmentez-la au fur et à mesure que vous comprenez la capacité de votre système. Il est plus facile d’augmenter une limite que de se remettre d’un serveur surchargé.