REST API расписания: преобразование iCal в JSON, поиск и OpenAPI.
Университет публикует расписание в iCal: формат подходит календарным приложениям, но неудобен для ботов и веб-сервисов. Клиентам нужен структурированный JSON, поиск групп, преподавателей и кабинетов, а также понятная работа с учебной неделей.
Парсер изолирует особенности календарного файла и преобразует события в стабильную структуру API. Клиентам не нужно разбирать iCal самостоятельно.
Боты и приложения получают одинаковые нормализованные данные независимо от исходного представления.
API поддерживает точный запрос по идентификатору и поиск по названию. Отдельный метод поиска помогает сначала найти группу, преподавателя или кабинет.
Интеграция подходит и для сохранённых идентификаторов, и для пользовательского поиска.
Полученные и разобранные данные сохраняются с TTL. Частые клиентские запросы не требуют каждый раз обращаться к университетскому источнику и повторно разбирать файл.
Ответы выдаются быстрее, а зависимость от доступности внешнего источника уменьшается.
Контракт опубликован через OpenAPI, а сервис упакован для запуска в Docker. Методы и формат ответа можно проверить до подключения клиентского приложения.
API проще развернуть, исследовать и подключить к новому потребителю.
Публичный API стал единой точкой доступа к расписанию.