Limitation du taux
Limites globales de la demande
L'API est limitée à 150 demandes toutes les 60 secondes. Toutes les demandes sont prises en compte dans ce total. Chaque demande traitée par l'API renvoie des informations sur la limitation du débit dans les en-têtes HTTP.
Note : La limitation du débit est basée à la fois sur le nom d'utilisateur et l'adresse IP. Par conséquent, un seul nom d'utilisateur est limité à 150 demandes toutes les 60 secondes, tout comme une seule adresse IP.
Limites des demandes de statistiques
Les demandes de statistiques sont limitées à 30 demandes par minute pour chaque adresse IP et à 25 demandes par minute pour chaque nom d'utilisateur.
Note : L'IP et le nom d'utilisateur de chaque demande de statistiques sont pris en compte dans ces limites.
Par exemple, si vous vous connectez avec votre nom d'utilisateur sur un seul ordinateur et que vous effectuez 25 demandes de statistiques, la prochaine demande échouera. Cependant, vous pouvez changer de nom d'utilisateur et effectuer 5 autres demandes de statistiques avant d'atteindre la limite d'adresses IP.
Exemples
Limitation des taux - 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 erreur HTTP 429 Too Many Requests (trop de demandes) est générée par toutes les demandes suivantes jusqu'à ce que la limite de débit soit réinitialisée. Comme pour une demande normale, les informations relatives à la limitation du débit seront disponibles dans les en-têtes HTTP.
Limitation du débit - Exemple 2 (Limite dépassée)
$ curl -i https://api.example.com/v2/statistics/a/date
{
"HTTP/1.1": "429 Too Many Requests",
"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
}