La règle
Si le même appel est effectué plus de 3 fois en 1 minute, les tentatives suivantes sont bloquées et vous ne pouvez plus effectuer cet appel pendant 10 minutes.Ce qui constitue un même appel
Deux appels sont identiques lorsqu’ils portent la même charge utile, ce qui, en pratique, signifie qu’ils sont effectués avec le même identifiant. Les appels avec un identifiant ou une charge utile différents sont comptabilisés séparément.Pourquoi cette limite existe
Les appels identiques répétés proviennent généralement de boucles de nouvelle tentative, de tâches dupliquées ou de bogues d’intégration. Chaque appel est facturable : la limite empêche donc ces appels incontrôlés d’accumuler des frais.Que se passe-t-il lorsque vous êtes bloqué
Un appel bloqué renvoie429 Too Many Requests. Le blocage de 10 minutes démarre lorsque la limite est atteinte. Le minuteur ne redémarre pas si vous continuez à appeler pendant le blocage : le blocage prend donc fin 10 minutes après son début.
Bonnes pratiques recommandées
- Conservez le résultat d’une vérification et réutilisez-le plutôt que d’appeler à nouveau avec le même identifiant.
- Ne réessayez pas dans une boucle serrée. Lorsque vous recevez une erreur
429, arrêtez-vous et attendez. - Utilisez les Données de test dans le sandbox afin que vos tests ne déclenchent pas la limite.
- Consultez Erreurs pour savoir comment gérer les autres réponses d’erreur.