Статистика трафика

Возвращает использование трафика, агрегированное по дням, с оценочной стоимостью за каждый день. Фильтруется по диапазону дат и, опционально, по одному доступу к прокси или IP из whitelist.

Получить статистику

Endpoint

GET /api/v2/rotating-proxies/stats/

Параметры запроса

Параметр	Тип	Обязательный	Описание
date_from	string	Нет	Дата начала YYYY-MM-DD (по умолчанию: 7 дней назад)
date_to	string	Нет	Дата окончания YYYY-MM-DD (по умолчанию: сегодня)
sub_user_id	string	Нет	Ограничить одним доступом к прокси (UUID)
ip_id	string	Нет	Ограничить одним IP из whitelist (UUID)

sub_user_id и ip_id взаимоисключающие.

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v2/rotating-proxies/stats/?date_from=2026-06-18&date_to=2026-06-24' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Ответ

{
  "spent_mb": 1340,
  "timeline": [
    { "date": "2026-06-20", "traffic_mb": 420, "price_usd": 1.23 },
    { "date": "2026-06-21", "traffic_mb": 510, "price_usd": 1.49 },
    { "date": "2026-06-22", "traffic_mb": 410, "price_usd": 1.20 }
  ]
}

Поля ответа

Поле	Тип	Описание
spent_mb	integer	Всего потреблено трафика за диапазон, в МБ
timeline	array	Разбивка по дням
timeline[].date	string	День в формате YYYY-MM-DD
timeline[].traffic_mb	integer	Трафик, потребленный в этот день, в МБ
timeline[].price_usd	number	Оценочная стоимость трафика за этот день в USD

Ответы с ошибками

Неверные параметры (400)

{
  "detail": "date_from must be YYYY-MM-DD."
}

{
  "detail": "user_id and ip_id are mutually exclusive."
}

Нет активной подписки (404)

{
  "detail": "No active rotating proxy subscription."
}

Примечания

• Дни без трафика исключаются из timeline.
• price_usd вычисляется из цены за ГБ вашего плана и является оценкой для отчетности; авторитетный биллинг отражается в балансе вашего аккаунта.