RTU MIREA Schedule API

REST API для получения расписания РТУ МИРЭА. Данные берутся с schedule-of.mirea.ru через открытый API (iCal-формат) и отдаются клиенту как чистый JSON.

Эндпоинты

Поиск

GET /api/search?query={запрос}&limit=15

Ищет группы, преподавателей и кабинеты по имени.

Пример:

curl "http://localhost:8001/api/search?query=БСБО-11-23"

{
  "data": [
    {
      "id": 708,
      "title": "БСБО-11-23",
      "full_title": "БСБО-11-23",
      "target": 1
    }
  ]
}

Значения поля target: 1 — группа, 2 — преподаватель, 3 — кабинет.

---

Расписание по ID

GET /api/schedule/{type}/{id}?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD

Возвращает расписание для группы, преподавателя или кабинета за указанный период. По умолчанию date_from и date_to — сегодняшняя дата.

Параметр	Описание
type	1 — группа, 2 — преподаватель, 3 — кабинет
id	ID из результатов поиска
date_from	Начало периода (включительно)
date_to	Конец периода (включительно)

Примеры:

# Расписание группы за неделю
curl "http://localhost:8001/api/schedule/1/708?date_from=2026-02-23&date_to=2026-03-01"

# Расписание преподавателя на день
curl "http://localhost:8001/api/schedule/2/1909?date_from=2026-02-27&date_to=2026-02-27"

# Расписание кабинета
curl "http://localhost:8001/api/schedule/3/135?date_from=2026-02-27&date_to=2026-02-27"

{
  "lessons": [
    {
      "date": "2026-02-24",
      "time_start": "09:00",
      "time_end": "10:30",
      "discipline": "Разработка веб-приложений",
      "lesson_type": "ЛК",
      "lesson_type_full": "Лекции",
      "teachers": [{ "id": 1909, "name": "Потапов Сергей Олегович" }],
      "groups": [{ "id": 708, "name": "БСБО-11-23" }],
      "room": { "id": 135, "number": "145б", "campus": "С-20" }
    }
  ],
  "date_from": "2026-02-24",
  "date_to": "2026-03-01"
}

---

Расписание по названию

GET /api/schedule/by-name?query={запрос}&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&target={тип}

Удобный endpoint — не нужно предварительно узнавать ID. Принимает название группы, преподавателя или кабинета, сам находит нужный ID и возвращает расписание.

Параметр	Обязателен	Описание
query	да	Название группы, преподавателя или кабинета
date_from	нет	Начало периода (по умолчанию — сегодня)
date_to	нет	Конец периода (по умолчанию — сегодня)
target	нет	Фильтр типа: 1 — группа, 2 — преподаватель, 3 — кабинет

Примеры:

# Расписание группы на сегодня
curl "http://localhost:8001/api/schedule/by-name?query=БСБО-11-23"

# Расписание преподавателя за неделю
curl "http://localhost:8001/api/schedule/by-name?query=Потапов&date_from=2026-02-23&date_to=2026-03-01"

# Если запрос неоднозначен — уточнить тип
curl "http://localhost:8001/api/schedule/by-name?query=145б&target=3&date_from=2026-02-27&date_to=2026-02-27"

{
  "matched_id": 708,
  "matched_title": "БСБО-11-23",
  "matched_target": 1,
  "matched_target_name": "Группа",
  "lessons": [...],
  "date_from": "2026-02-27",
  "date_to": "2026-02-27"
}

---

Номер недели

GET /api/week

curl "http://localhost:8001/api/week"

{
  "weekNumber": 3,
  "schedulePeriodType": "Semester",
  "start": "2026-02-08T21:00:00+00:00",
  "end": "2026-06-14T20:59:59+00:00"
}

---

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

OpenAPI-документация доступна по адресу /schema после запуска.

Запуск

Docker (рекомендуется)

cp .env.example .env  # при необходимости отредактировать
docker compose up -d

API будет доступен на http://localhost:${PORT} (по умолчанию 8000).

Локально (uv)

cp .env.example .env  # при необходимости отредактировать
uv sync
uv run python runserver.py

Конфигурация

Переменные окружения (см. .env.example):

Переменная	По умолчанию	Описание
PORT	8000	Порт сервера
DEBUG	false	Уровень логирования DEBUG + reload в uvicorn при локальном запуске
CACHE_TTL	3600	TTL кеша iCal-ответов (секунды)

Технологии

• Litestar — веб-фреймворк
• httpx — асинхронный HTTP-клиент
• icalendar + recurring-ical-events — парсинг расписания
• cachetools — in-memory TTL-кеш
• uv — управление зависимостями