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.
Chaque requête vers un site, à site/{site_id}/, compte dans ces trois limites :
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 :
{
"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.
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
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.