Amio API has different rate limits for each pricing plan. We limit number of requests you can do within a hour. And number of simultaneous connections you can have opened to Amio servers.
| Pricing Plan | Number of Requests | Simultaneous Connections |
|---|---|---|
| Free | 1000 | 3 |
| Developer | 2000 | 10 |
| Enterprise | custom | custom |
You can check the returned HTTP headers of any API request to see your current rate limit status for maximum number of requests:
curl -i https://api.amio.io/v1/channels/{{channel_id}}
HTTP/1.1 200 OK
Date: Mon, 01 Jul 2013 17:27:06 GMT
Status: 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1491820066
| HTTP Response Header | Description |
|---|---|
| X-RateLimit-Limit | The maximum number of requests that you are permitted to make per hour. |
| X-RateLimit-Remaining | Remaining number of requests. |
| X-RateLimit-Reset | Remaining time before the rate limit resets, in UTC epoch seconds. |
Once you go over the rate limit you will receive an error response:
{
"timestamp": "2016-12-21T11:17:56.397Z",
"status": {
"code": "429",
"message": "Too Many Requests"
},
"errors": [
{
"message": "You have exceeded maximum number of requests and have been temporarily blocked. See documentation for more details: https://docs.amio.io/reference#rate-limiting"
}
]
}