ДОКУМЕНТАЦИЯ
Квоты и частота запросов
Учитывайте аккаунт, а не домен или ключ.
Что расходует единицу#
| Ситуация | Учёт |
|---|---|
| Допущенный авторизованный запрос, расходующий квоту | 1 единица, в том числе для ответа из кеша и допустимого поиска с результатом 404 |
| Неверный ключ, недостаточная область доступа, ошибка валидации, OPTIONS/HEAD, 429, ошибка сервера | Не расходуют квоту; ограничения от злоупотреблений действуют |
| GET /me/usage | 0 единиц квоты; ограничения частоты по аккаунту, IP и общие ограничения действуют |
| Допущенный повторный запрос | Новый запрос и новая единица |
Лимиты хранения и передачи файлов учитываются отдельно от квоты запросов. См. лимиты загрузки ZIP и лимиты скачивания.
Заголовки и ожидание#
X-Quota-Limit/Remaining — единицы периода, X-Quota-Reset — время Unix в секундах. RateLimit-Reset — длительность окна ограничения частоты в секундах. Для 429 следуйте Retry-After; идентификатор запроса приходит в X-Request-Id и meta.requestId.
- При 429 следуйте Retry-After, добавляйте случайную задержку и ограничивайте число повторов. Не обходите лимиты зеркалами.
- Показатели в кабинете могут обновляться с задержкой; текущий расход доступен через GET /me/usage.
- При недоступности учёта или проверки частоты API возвращает 503.
Записанный ответ GET /me/usage из локальной тестовой среды. Значения отражают расход на момент запроса.
GET /public/v1/me/usage
HTTP response
HTTP/1.1 200
ratelimit-limit: 60
ratelimit-remaining: 58
ratelimit-reset: 60
x-request-id: 2227dfcb-83b1-494c-890e-078dc5a62bb8
cache-control: no-store
content-type: application/json; charset=utf-8
{
"success": true,
"data": {
"plan": {
"code": "free",
"name": "Free",
"priceMinor": 0,
"currency": "RUB",
"periodDays": 30,
"quota": 10000,
"rateLimit": 60,
"projectLimit": 1,
"keyLimit": 2
},
"periodStart": "2026-11-13T07:56:55.835Z",
"periodEnd": "2026-12-13T07:56:55.835Z",
"used": 3,
"limit": 10000,
"remaining": 9997
},
"meta": {
"requestId": "2227dfcb-83b1-494c-890e-078dc5a62bb8",
"apiVersion": "v1"
}
}