Лимиты запросов (Rate Limiting)
Renta REST API накладывает лимиты на частоту запросов (rate limits) для обеспечения стабильности системы и честного использования ресурсов.
Лимиты применяются к пользователю для всех ресу рсов API.
| Тип лимита | Значение |
|---|---|
| В минуту | 120 запросов в минуту |
| В час | 2000 запросов в час |
Заголовки Rate Limiting
Каждый ответ API включает заголовки, которые позволяют отслеживать текущее использование квоты:
| Заголовок | Описание |
|---|---|
| X-RateLimit-Limit-Minute | Максимальное количество запросов, разрешенных в минуту. |
| X-RateLimit-Remaining-Minute | Количество запросов, оставшихся в текущем минутном окне. |
| X-RateLimit-Reset-Minute | UNIX-таймштамп момента сброса текущего минутного окна. |
| X-RateLimit-Limit-Hour | Максимальное количество запросов, разрешенных в час. |
| X-RateLimit-Remaining-Hour | Количество запросов, оставшихся в текущем часовом окне. |
| X-RateLimit-Reset-Hour | UNIX-таймштамп момента сброса текущего часового окна. |
Если вы превысите квоту, API ответит ошибкой HTTP 429 Too Many Requests.
Тело ответа содержит подробную информацию о превышенном лимите:
{
"is_success": false,
"data": {
"error_code": 429,
"message": "Rate limit exceeded: 120 requests per minute",
"limit_type": "minute",
"limit": 120,
"remaining": 0,
"reset_time": 1758459864
}
}Объяснение параметров ответа при превышении лимита
| Параметр | Тип | Описание |
|---|---|---|
| error_code | integer | HTTP-код статуса, указывающий на тип ошибки. 429 означает "Too Many Requests" |
| message | string | Понятное сообщение об ошибке с описанием произошедшего и текущего лимита |
| limit_type | string | Временное окно лимита. Указывае т, применен ли лимит за минуту или за час. |
| limit | integer | Максимальное количество запросов, разрешенных в данном временном окне |
| remaining | integer | Количество запросов, оставшихся до достижения лимита. 0 означает превышение лимита |
| reset_time | integer | UNIX-таймштамп (секунды с начала эпохи), когда окно лимита сбросится и запросы снова будут разрешены |
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.