Техническое задание: Настройка ограничений запросов (Rate Limiting) и защиты от всплесков трафика

Цель проекта

Реализовать на уровне сервера надёжную систему контроля и ограничения частоты запросов к публичному API для обеспечения стабильности и защиты от злоупотреблений.

Основные требования

1. Базовый функционал Rate-Limiting

Внедрение ограничений на основе скользящего окна (sliding window).
Настройка двух независимых уровней лимитов:
- Per-IP: Ограничение количества запросов с одного IP-адреса.
- Per-API-Key: Ограничение количества запросов по уникальному ключу доступа.
Реализация базовой защиты от бурстов (резких всплесков трафика).

2. Корректное информирование клиентов

При исчерпании лимита сервер должен возвращать чёткие и понятные HTTP-ответы (например, статус 429 Too Many Requests).
В заголовках ответа (headers) должны передаваться актуальные данные о лимитах и текущем использовании.

3. Расширенные квоты для партнёров

Предусмотреть возможность настройки отдельных, повышенных лимитов для запросов, поступающих от партнёрских интеграций или доверенных клиентов.
Механизм должен быть гибким и управляемым.

Ожидаемый результат

Стабильный и защищённый API, который корректно обрабатывает высокие нагрузки, предотвращает злоупотребления и предоставляет клиентам прозрачную информацию о статусе их запросов.

интеграция