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

Администратор

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

v2.0

Техническая поддержка

Возникли вопросы по интеграции? Наши инженеры на связи 24/7.

GET /api/v1/news

Получение списка новостей

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

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

Параметр	Тип	Описание
sport	string	Slug вида спорта (football, basketball, etc.)
offset	int	Смещение (по умолчанию: 0)
limit	int	Кол-во записей (1-100, по умолчанию: 20)

Пример ответа (JSON)

{
  "items": [
    {
      "id": 1,
      "title": "Новый трансфер в Ла Лиге",
      "sport_id": 1,
      "source_domain": "sports.ru",
      "published_at": "2026-03-04T12:00:00Z"
    }
  ],
  "total": 1847,
  "offset": 0,
  "limit": 20
}

GET /api/v1/news

GET /api/v1/news/{id}

Получение новости по ID

Детальная информация о конкретной новости, включая полный текст, AI-обработанный контент и вложения.

GET /api/v1/news/trending

Трендовые новости

Последние опубликованные новости. Параметр: limit (по умолчанию: 10, макс: 50).

GET /api/v1/predictions

Получение списка прогнозов

Возвращает список AI-прогнозов на матчи с фильтрами по виду спорта, эксперту и статусу.

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

Параметр	Тип	Описание
sport_id	int	ID вида спорта
expert_id	int	ID виртуального эксперта
status	string	Статус: pending, won, lost
offset	int	Смещение (по умолчанию: 0)
limit	int	Кол-во записей (1-100, по умолчанию: 20)

Пример ответа (JSON)

{
  "items": [
    {
      "id": 42,
      "match_id": 128,
      "expert_id": 1,
      "status": "pending",
      "blocks": {...},
      "created_at": "2026-03-04T10:30:00Z"
    }
  ],
  "total": 356,
  "offset": 0,
  "limit": 20
}

GET /api/v1/predictions

GET /api/v1/predictions/{id}

Получение прогноза по ID

Полная информация о прогнозе: все 7 блоков анализа, данные матча, статистика эксперта.

GET /api/v1/predictions/{id}/blocks

Блоки прогноза

Получение блоков анализа конкретного прогноза (pre_match, head_to_head, form, key_factors, prediction, best_bets).

GET /api/v1/matches

Получение списка матчей

Список предстоящих и прошедших матчей с фильтрацией по виду спорта, лиге и дате.

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

Параметр	Тип	Описание
sport_id	int	ID вида спорта
status	string	Статус матча
date_from	datetime	Начало периода (ISO 8601)
date_to	datetime	Конец периода (ISO 8601)
offset	int	Смещение (по умолчанию: 0)
limit	int	Кол-во записей (1-100, по умолчанию: 20)

Пример ответа (JSON)

{
  "items": [
    {
      "id": 128,
      "sport_id": 1,
      "home_team": "Arsenal",
      "away_team": "Chelsea",
      "start_time": "2026-03-05T20:00:00Z",
      "status": "scheduled"
    }
  ],
  "total": 64,
  "offset": 0,
  "limit": 20
}

GET /api/v1/matches

GET /api/v1/matches/{id}

Получение матча по ID

Полная информация о матче: команды, счёт, статистика, связанные прогнозы всех экспертов.

GET /api/v1/experts

Список виртуальных экспертов

Возвращает список AI-персон (виртуальных экспертов) с их профилями, стилями и статистикой точности.

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

Параметр	Тип	Описание
sport_id	int	ID вида спорта для фильтрации
offset	int	Смещение (по умолчанию: 0)
limit	int	Кол-во записей (1-100, по умолчанию: 20)

Пример ответа (JSON)

{
  "items": [
    {
      "id": 1,
      "name": "Виктор Аналитик",
      "avatar_url": "/uploads/expert_1.png",
      "sport_id": 1,
      "enabled": true
    }
  ],
  "total": 4,
  "offset": 0,
  "limit": 20
}

GET /api/v1/experts

GET /api/v1/experts/{id}

Профиль эксперта

Полный профиль виртуального эксперта: стиль, тон, специализация, промпт-шаблон и статистика.

GET /api/v1/experts/{id}/accuracy

Точность эксперта

Статистика точности: общее количество прогнозов, выигранные, проигранные, процент точности, ROI.

Способ 1: API-ключ (рекомендуемый)

Передайте API-ключ в заголовке X-API-Key каждого запроса. Ключ создаётся в разделе API-ключи.

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

GET /api/v1/news HTTP/1.1
Host: localhost:8005
X-API-Key: your-api-key-here

Параметры доступа

Параметр	Описание
access_type	Разрешённые ресурсы: news, predictions, matches, experts
rate_limit_hour	Лимит запросов в час (по умолчанию: 1000)
rate_limit_day	Лимит запросов в день (по умолчанию: 10000)
ip_filter	Ограничение по IP-адресам (опционально)

warning

Важно

API-ключ показывается только при создании. Храните его в безопасном месте. При компрометации удалите ключ и создайте новый.

POST /auth/token

Способ 2: JWT-токен (для администраторов)

Авторизация по email и паролю. Возвращает JWT-токен для передачи в заголовке Authorization: Bearer <token>.

Тело запроса (JSON)

Поле	Тип	Описание
email	string	Email пользователя
password	string	Пароль

Пример ответа (JSON)

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "bearer"
}

POST /auth/token

Заголовки Rate Limit

При использовании API-ключа ответ содержит заголовки с информацией о лимитах:

Заголовок	Описание
X-RateLimit-Limit-Hour	Максимум запросов в час
X-RateLimit-Remaining-Hour	Оставшиеся запросы в текущем часе
X-RateLimit-Limit-Day	Максимум запросов в день
X-RateLimit-Remaining-Day	Оставшиеся запросы в текущем дне

error

HTTP 429 Too Many Requests

Возвращается при превышении лимита запросов. Подождите или увеличьте лимит в настройках ключа.