Rate Limiting
The API rate limiting is provided by the selected adidas API management platform – Mashery.
Rate limit information is provided in the for of HTTP headers. There are two types of rate limits: Quota and Throttle. The quota is a limit enforced per a longer period (typically a day). The throttle is the limit of calls per second.
Quota Limit
The limit on the number of calls per a period (day). The default quota limit is 5000 calls per day.
Example
Example response to a request over the quota limit:
HTTP/1.1 403 Forbidden
Content-Type: application/problem+json
X-Error-Detail-Header: Account Over Rate Limit
X-Mashery-Error-Code: ERR_403_DEVELOPER_OVER_RATE
{
"title": "Rate Limit Exceeded",
"detail": "Account Over Rate Limit"
}
Throttle Limit
The limit on the number of calls per second. The default throttle limit is two calls per second.
Example
Example response to a request over the throttle limit:
HTTP/1.1 403 Forbidden
Content-Type: application/problem+json
Retry-After: 1
X-Error-Detail-Header: Account Over Queries Per Second Limit
X-Mashery-Error-Code: ERR_403_DEVELOPER_OVER_QPS
{
"title": "Quota Limit Exceeded",
"detail": "Account Over Queries Per Second Limit"
}
NOTE: The
Retry-After
gives a hint how long before the same request should be repeated (in seconds).
Detail Information
By default, the headers do not contain details about the current usage and quotas. The default can be changed in the API management.
Example
A successful response with the details about throttle (X-Plan-QPS
) and quota (X-Plan-Quota
) rate limits:
HTTP/1.1 200 OK
X-Plan-QPS-Allotted: 10
X-Plan-QPS-Current: 1
X-Plan-Quota-Allotted: 1000
X-Plan-Quota-Current: 2
X-Plan-Quota-Reset: Tuesday, June 6, 2017 12:00:00 AM GMT