Перейти к основному содержанию
GET
/
v1
/
storage
/
stats
Получить статистику хранилища
curl --request GET \
  --url https://polza.ai/api/v1/storage/stats \
  --header 'Authorization: Bearer <token>'
{
  "usedBytes": 1024000,
  "totalBytes": 5368709120,
  "fileCount": 42,
  "filesByType": {
    "IMAGE": 30,
    "VIDEO": 8,
    "AUDIO": 2
  },
  "filesByPolicy": {
    "TEMP_UPLOAD": 15,
    "TEMP_GENERATION": 20,
    "PERMANENT": 7
  },
  "usagePercent": 19.05
}
Этот эндпоинт доступен только пользователям с ролью admin в организации. Обычный API-ключ не подойдёт — требуется JWT-авторизация через консоль.

​
Пример

curl "https://polza.ai/api/v1/storage/stats" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Ответ (200)

{
  "usedBytes": 1073741824,
  "totalBytes": 10737418240,
  "fileCount": 256,
  "filesByType": {
    "IMAGE": 180,
    "VIDEO": 50,
    "AUDIO": 26
  },
  "filesByPolicy": {
    "TEMP_UPLOAD": 30,
    "TEMP_GENERATION": 186,
    "PERMANENT": 40
  },
  "usagePercent": 10.0
}

​
Поля ответа

ПолеТипОписание
usedBytesnumberИспользованный объём в байтах
totalBytesnumberОбщий доступный объём
fileCountnumberОбщее количество файлов
filesByTypeobjectКоличество файлов по типам (IMAGE, VIDEO, AUDIO)
filesByPolicyobjectКоличество файлов по политикам хранения
usagePercentnumberПроцент использования хранилища

Авторизации

​
Authorization
string
header
обязательно

API ключ передаётся в заголовке: Authorization: Bearer <POLZA_AI_API_KEY>

Ответ

200 - application/json
​
usedBytes
number
обязательно

Использовано байт

Пример:

1024000

​
totalBytes
number
обязательно

Общий лимит байт

Пример:

5368709120

​
fileCount
number
обязательно

Количество файлов

Пример:

42

​
filesByType
object
обязательно

Количество файлов по типам

Пример:
{ "IMAGE": 30, "VIDEO": 8, "AUDIO": 2 }
​
filesByPolicy
object
обязательно

Количество файлов по политикам хранения

Пример:
{
  "TEMP_UPLOAD": 15,
  "TEMP_GENERATION": 20,
  "PERMANENT": 7
}
​
usagePercent
number
обязательно

Процент использования

Пример:

19.05