Модуль статистики данных

В производственных средах следует использовать HTTPS, чтобы гарантировать токены аутентификации. HTTP рекомендуется только для сред разработки.

Система агрегированной статистики для данных об использовании. Администраторы могут просматривать статистику по всему сайту, а пользователи — личную статистику. Данные группируются по модели и дате и используются для создания диаграмм и отчетов для отслеживания тенденций использования системы.

🔐 Аутентификация пользователя

Мое использование рассчитывается по дате

• Имя интерфейса: использование рассчитывается по дате.
• Метод HTTP: GET
• Путь: /api/data/self
• Требования аутентификации: Пользователь
• Введение в функцию: получение данных об использовании текущего пользователя по дате, поддержка запроса временного диапазона.

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

const response = await fetch('/api/data/self?start_timestamp=1640908800&end_timestamp=1640995200', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": [
    {
      "model_name": "gpt-3.5-turbo",
      "count": 25,
      "quota": 12500,
      "token_used": 2000,
      "created_at": 1640995200,
      "user_id": 1,
      "username": "testuser"
    },
    {
      "model_name": "gpt-4",
      "count": 10,
      "quota": 30000,
      "token_used": 1500,
      "created_at": 1640995200,
      "user_id": 1,
      "username": "testuser"
    }
  ]
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить персональную статистику"
}

🧾 Описание поля:

• start_timestamp (число): начальная временная метка, необязательно.
• start_timestamp (число): временная метка окончания, необязательно.
• start_timestamp (массив): список личной статистики
  • start_timestamp (строка): название модели.
  • start_timestamp (число): количество запросов.
  • start_timestamp (число): потребление квоты
  • start_timestamp (число): использование токена.
  • start_timestamp (число): дата и время статистики.
  • start_timestamp (числовой): идентификатор пользователя.
  • start_timestamp (строка): имя пользователя

🔐 Аутентификация администратора

Статистика использования по всему сайту на основе даты

• Имя интерфейса: статистика использования всего сайта по дате.
• Метод HTTP: GET
• Путь: start_timestamp
• Требования аутентификации: Администратор.
• Введение в функцию: получение общесистемной статистики использования сайта по дате, поддержка фильтрации по имени пользователя и запросу временного диапазона.

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

const response = await fetch('/api/data/?start_timestamp=1640908800&end_timestamp=1640995200&username=testuser', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_admin_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": [
    {
      "model_name": "gpt-3.5-turbo",
      "count": 150,
      "quota": 75000,
      "token_used": 12500,
      "created_at": 1640995200
    },
    {
      "model_name": "gpt-4",
      "count": 50,
      "quota": 150000,
      "token_used": 8000,
      "created_at": 1640995200
    }
  ]
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить статистику"
}

🧾 Описание поля:

• start_timestamp (число): начальная временная метка, необязательно.
• start_timestamp (число): временная метка окончания, необязательно.
• start_timestamp (строка): фильтрация имени пользователя, необязательно.
• start_timestamp (массив): список статистических данных, сгруппированных и агрегированных по модели и дате.
  • start_timestamp (строка): название модели.
  • start_timestamp (число): общее количество запросов.
  • start_timestamp (число): общее потребление квоты.
  • start_timestamp (число): общее использование токена.
  • start_timestamp (число): дата и время статистики.