PUBLIC API · v1
ДОКУМЕНТАЦИЯ

Квоты и частота запросов

Учитывайте аккаунт, а не домен или ключ.

API https://api.reduxhub.ru/public/v1

DL https://dl.reduxhub.ru

Только справка · запросов нет

Что расходует единицу#

СитуацияУчёт
Допущенный авторизованный запрос, расходующий квоту1 единица, в том числе для ответа из кеша и допустимого поиска с результатом 404
Неверный ключ, недостаточная область доступа, ошибка валидации, OPTIONS/HEAD, 429, ошибка сервераНе расходуют квоту; ограничения от злоупотреблений действуют
GET /me/usage0 единиц квоты; ограничения частоты по аккаунту, 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"
  }
}

ReduxHub Developers · API 1.0.0