Аналитика

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

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

GET /analytics

Параметр	Тип	Обязательный	Описание
from	number	Да	Начальная временная метка в миллисекундах Unix.
to	number	Да	Конечная временная метка в миллисекундах Unix.
apiKey	string	Нет	Фильтр по префиксу API-ключа (например, "bws_0a3ff5f7") или префиксу подписанного токена (например, "sup_a1b2c3d4"). Показывает только загрузки, выполненные с этим ключом или токеном.

Пример запроса

curl "https://api.ipfs.ninja/analytics?from=1711036800000&to=1711641600000" \
  -H "X-Api-Key: bws_your_api_key_here"

Ответ 200 OK

{
  "period": { "from": 1711036800000, "to": 1711641600000 },
  "totals": {
    "uploads": 42,
    "storageMB": 15.3,
    "fileTypes": { "json": 25, "image": 12, "pdf": 5 }
  },
  "daily": [
    { "date": "2026-03-21", "uploads": 20, "sizeMB": 8.1 },
    { "date": "2026-03-22", "uploads": 22, "sizeMB": 7.2 }
  ],
  "storageGrowth": [
    { "date": "2026-03-21", "cumulativeMB": 8.1 },
    { "date": "2026-03-22", "cumulativeMB": 15.3 }
  ],
  "gatewayBandwidthMB": 1200,
  "gatewayBandwidthLimitMB": 51200
}

TIP

gatewayBandwidthMB отражает использование за текущий месяц независимо от диапазона from/to. Фильтр apiKey применяется только к метрикам загрузки — пропускная способность шлюза рассчитывается по всему аккаунту. Префиксы подписанных токенов загрузки хранятся в том же поле, что и префиксы API-ключей, поэтому вы можете фильтровать по префиксу подписанного токена (например, sup_a1b2c3d4), чтобы увидеть загрузки, выполненные с определённым подписанным токеном.