Limites de débit


Les limites empêchent une intégration très active de ralentir tous les autres. Chaque site a ses propres limites pour chaque appelant, de sorte que le trafic vers un site n'épuise jamais les limites d'un autre.


Requêtes vers un site

Chaque requête vers un site, à site/{site_id}/, compte dans ces trois limites :

  • 50 requêtes en 5 secondes
  • 250 requêtes par minute
  • 5 000 requêtes par heure

Dépasser une limite bloque les requêtes suivantes vers ce site pendant 1 minute, ou pendant 1 heure s'il s'agit de la limite horaire. Une requête bloquée reçoit le code HTTP 429 et cette réponse :

Réponse de limitation de débit
			
{
  "success": false,
  "errors": [
    "Please wait before trying again."
  ]
}


		

Toutes les requêtes provenant d'une même adresse IP, vers n'importe quel site, partagent également une limite de 5 000 par minute. Tout dépassement bloque cette adresse pendant 3 minutes, avec le code HTTP 429 et le message The request limit has been exceeded. Please wait before sending more.


Lecture d'enregistrements

Les points de terminaison Get et List ont une limite supplémentaire : 10 requêtes en 5 minutes vers la même URL, pour chaque site et chaque appelant. La chaîne de requête ne fait pas partie de l'URL ici, donc chaque page d'une liste compte dans les mêmes 10. Dépasser cette limite bloque cette URL pendant 5 minutes, avec le message Access to this resource has been throttled. Please wait before trying again.

Demander un enregistrement qui n'existe pas compte pour deux requêtes dans chacune des limites ci-dessus.

Get Payment fonctionne différemment : il n'a aucune de ces deux règles et, à la place, chaque paiement peut être lu une fois toutes les 55 secondes. Chaque identifiant par lequel vous le lisez compte séparément. Lire à nouveau le même paiement plus tôt retourne HTTP 400 avec success à false et le message You have hit the throttle limit for this payment, please try again in a minute


Taille de la requête

Le corps d'une requête peut contenir jusqu'à 1 Mo de JSON. Un corps plus volumineux reçoit le code HTTP 413 et Request body too large. Le renvoyer échoue de la même façon; divisez-le donc en requêtes plus petites.


Rester sous les limites

  • Échelonnez les téléversements en masse au lieu de tout envoyer en une seule fois.
  • Utilisez les webhooks pour être informé des paiements au lieu de les redemander sans cesse.
  • Quand vous recevez un code 429, attendez la fin du blocage avant d'envoyer d'autres requêtes.

Consultez Erreurs pour tous les codes d'état.