mirror of
https://github.com/adidas/api-guidelines.git
synced 2025-10-25 15:19:19 +00:00
64 lines
1.8 KiB
Markdown
64 lines
1.8 KiB
Markdown
# 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
|
||
```
|