Перейти к основному содержимому

Документация ServerCon API

Добро пожаловать в документацию ServerCon API v3.2! Этот мощный API предоставляет комплексные возможности мониторинга игровых серверов, аналитики и управления с улучшенной системой обработки ошибок и стандартизированными HTTP статус-кодами.

🚀 Что нового в версии 3.2​

Наша последняя версия включает значительные улучшения и новые функции:

🛡️ Стандартизированная система HTTP статус-кодов​

  • Полная стандартизация всех ответов API с правильными HTTP кодами
  • Детальные коды ошибок с описаниями и подсказками
  • Структурированные ответы с единым форматом для успеха и ошибок
  • Документация статус-кодов встроенная в API (/api/v1/docs)

🎯 Улучшенная обработка ошибок​

  • 401 Unauthorized - Отсутствует или неверный API ключ
  • 403 Forbidden - Недостаточно прав для операции
  • 404 Not Found - Ресурс не найден
  • 422 Unprocessable Entity - Ошибка валидации данных
  • 429 Too Many Requests - Превышен лимит запросов
  • 500 Internal Server Error - Внутренняя ошибка сервера

🧪 Расширенное тестирование​

  • Специальные тесты ошибок для проверки всех статус-кодов
  • Быстрый тест ошибок (quick_error_test.py)
  • Интерактивное тестирование с новыми категориями
  • Автоматическая проверка документации API

🚀 Что нового в версии 3.1​

🛡️ Система блокировки IP адресов​

  • Автоматическая и ручная блокировка подозрительных IP
  • Whitelist доверенных IP с обходом всех проверок
  • Временная блокировка с автоматическим снятием
  • Диапазоны IP поддержка подсетей и CIDR
  • Логирование подозрительной активности с автоблокировкой

🤖 Telegram Bot для администрирования​

  • Полное управление API через Telegram команды
  • Автоматические уведомления о событиях в канал
  • Блокировка IP прямо из Telegram
  • Мониторинг серверов в реальном времени
  • Статистика использования API

🚀 Что нового в версии 3.0​

💳 Система подписок API​

  • Многоуровневая система подписок с различными лимитами
  • 6 типов подписок: Free, Basic, Premium, Professional, Enterprise, Administrator
  • Гибкие лимиты: почасовые, дневные и месячные ограничения
  • Автоматическое управление сроками действия подписок

📊 Мониторинг и аналитика использования​

  • Детальное логирование всех API запросов
  • Статистика использования по дням, эндпоинтам, пользователям
  • Автоматическая очистка старых данных
  • Заголовки лимитов в HTTP ответах

🎯 Ключевые возможности​

⚡

Мониторинг в реальном времени

Мониторинг 40+ типов игр с временем отклика менее секунды и полными данными сервера.

📈

Продвинутая аналитика

Глубокая аналитика трендов игроков, производительности серверов и популярности игр с историческими данными.

🔒

Безопасный API

Аутентификация по Bearer токену с ограничением скорости и комплексным контролем доступа.

🌐

Глобальное покрытие

Мониторинг серверов по всему миру с региональной оптимизацией и поддержкой множества протоколов.

🛠️

Гибкая настройка

Настраиваемые параметры мониторинга, фильтрация и сортировка данных по вашим требованиям.

📊

Экспорт данных

Экспорт статистики в различных форматах для дальнейшего анализа и интеграции.

🎮 Поддерживаемые игры​

Мы поддерживаем 40+ типов игр, включая популярные:

ИграПротоколОсобые функции
MinecraftminecraftИнтеграция mcapi.us, определение версий, поддержка Java/Bedrock
Counter-Strike 2source2Продвинутые запросы Source движка
CS:GOsourceПолная поддержка протокола Source
RageMPragempИнтеграция API rageservers.ru
Alt:ValtvНативный API с мастер-сервером
SAMPsampРеализация нативного протокола
RustrustИнтеграция Steam API
Garry's ModsourceОпределение Workshop и аддонов
ARK: SurvivalarkИнформация о модах и картах

Посмотреть все поддерживаемые игры →

🚀 Быстрый старт​

Начните работу с ServerCon API за несколько минут:

1. Получите API ключ​

# Свяжитесь с поддержкой ServerCon для получения API ключа
# Или используйте наш тестовый ключ для разработки: "test_key_12345"

2. Сделайте первый запрос​

const response = await fetch('http://138.124.109.53:5000/api/v1/servers', {
  headers: {
    'Authorization': 'Bearer ВАШ_API_КЛЮЧ',
    'Content-Type': 'application/json'
  }
});

const result = await response.json();
console.log(`Найдено ${result.data.length} серверов`);

3. Исследуйте данные​

// Получить серверы конкретной игры
const minecraftServers = await fetch('http://138.124.109.53:5000/api/v1/servers/game/30', {
  headers: { 'Authorization': 'Bearer ВАШ_API_КЛЮЧ' }
});

// Получить статистику игр
const gameStats = await fetch('http://138.124.109.53:5000/api/v1/games/stats?days=7', {
  headers: { 'Authorization': 'Bearer ВАШ_API_КЛЮЧ' }
});

4. Тестирование ошибок​

# Быстрый тест основных ошибок
python quick_error_test.py

# Полное тестирование с новыми категориями
python test_api.py --errors

# Интерактивный режим с тестами ошибок
python test_api.py --interactive

📚 Что дальше?​

🔑 Настройка аутентификации

📖 Справочник API

💡 Посмотреть примеры

🆘 Нужна помощь?​

Готовы начать мониторинг?

Начать сейчас →