Skip to main content
Cette page a été mise à jour le 2 octobre 2026.

Introduction

Afin de garantir un temps de réponse faible et un service fiable pour chaque marchand, l’API HUB2 applique des limites de flux, plus strictes sur les points de terminaison les plus coûteux en ressources. Sauf mention contraire dans la colonne Notes, les limites sont comptées par adresse IP du client : le trafic d’un utilisateur de l’API n’a donc pas d’impact sur celui d’un autre.

Limites de l’API

Le tableau ci-dessous liste les limites propres à certains points de terminaison. La limite globale s’applique à tous les points de terminaison non listés.
La limite réelle est la limite appliquée par l’API, en nombre de requêtes par fenêtre de temps.
La limite convertie l’exprime en requêtes par minute pour comparer les valeurs sur une même échelle.
Les limites par :id, par jeton et par marchand sont comptées par ressource (et par IP de l’appelant pour les intentions de paiement et les jetons), par jeton de paiement ou par compte marchand.
Ces limites s’appliquent au trafic sandbox comme au trafic live.
Réduisez le trafic sandbox si votre volume de transactions est important.

Gérer les limites

Lorsque l’API reçoit une requête au-delà de la limite d’un point de terminaison, elle la rejette avec le statut HTTP 429 Too Many Requests et ne la traite pas.
Consultez la documentation MDN pour en savoir plus sur ce statut.
Les en-têtes de réponse HTTP suivants permettent de gérer les limites :

Approche réactive (plus simple)

Côté client, l’approche la plus simple consiste à relancer une requête après le délai indiqué par Retry-After lorsqu’elle échoue avec un statut 429 :

Approche proactive (plus avancée)

L’approche proactive consiste à maintenir une réserve de jetons de requête dimensionnée selon la limite du point de terminaison ciblé. Chaque requête consomme un jeton ; lorsque la réserve est vide, la requête suivante attend qu’un jeton se libère. Consultez cet article sur la mise en œuvre de la limitation côté client, en particulier les approches 4 et 4.1.

Évolutions

Les limites de flux préviennent les abus et maintiennent un service fiable pour tous. HUB2 travaille en continu sur la stabilité et les performances de l’API, et cette page est mise à jour à chaque changement de limite.