Limitation du débit

Limites globales des requêtes

L'API est limitée à 150 requêtes toutes les 60 secondes. Toutes les requêtes sont comptabilisées dans le total. Chaque requête traitée par l'API renvoie des informations de limitation de débit dans les en-têtes HTTP.

Remarque: La limitation de débit est basée à la fois sur le nom d'utilisateur et l'adresse IP. Par conséquent, un même nom d'utilisateur est limité à 150 requêtes toutes les 60 secondes, tout comme une même adresse IP.

Limites des requêtes de connexion

Les requêtes de connexion sont limitées à 10 requêtes toutes les 60 secondes. Toutes les requêtes sont comptabilisées dans le total.

Remarque: L'adresse IP et le nom d'utilisateur de chaque requête de statistiques effectuée seront comptabilisés dans ces limites.

Limites des requêtes de statistiques

Les requêtes de statistiques sont limitées à 30 requêtes par minute pour chaque adresse IP et 25 requêtes par minute pour chaque nom d'utilisateur.

Remarque: L'adresse IP et le nom d'utilisateur de chaque requête de statistiques effectuée seront comptabilisés dans ces limites.

Par exemple, si vous vous connectez avec votre nom d'utilisateur sur un seul ordinateur et effectuez 25 requêtes de statistiques, la suivante échouera. Cependant, vous pourriez passer à un autre nom d'utilisateur et effectuer 5 requêtes de statistiques supplémentaires, avant d'atteindre la limite d'adresse IP.

Exemples

Limitation de débit - Exemple 1

$ curl -i https://api.example.com/v2/statistics/a/date

{
  "HTTP/1.1": "200 OK",
  "Date": "Fri, 24 Oct 2014 14:57:32 GMT",
  "Content-Type": "application/json",
  "Transfer-Encoding": "chunked",
  "X-Rate-Limit-Limit": 25,
  "X-Rate-Limit-Remaining": 44,
  "X-Rate-Limit-Reset": 27
}

Lorsque la limite de débit est dépassée, une 429 Trop de requêtes erreur HTTP sera renvoyée par toute requête ultérieure jusqu'à la réinitialisation de la limite de débit. Comme pour une requête normale, les informations de limitation de débit seront disponibles dans les en-têtes HTTP.

Limitation de débit - Exemple 2 (limite dépassée)

$ curl -i https://api.example.com/v2/statistics/a/date

{
  "HTTP/1.1": "429 Trop de requêtes",
  "Date": "Fri, 24 Oct 2014 15:04:35 GMT",
  "Content-Type": "application/json",
  "Transfer-Encoding": "chunked",
  "X-Rate-Limit-Limit": 25,
  "X-Rate-Limit-Remaining": 0,
  "X-Rate-Limit-Reset": 12
}