1305 подписчиков
Engee вне браузера: управление расчетами через внешний API
В декабрьском релизе в Engee появилась поддержка внешнего HTTP API с авторизацией через Personal Access Token. Это позволяет работать с Engee не только через веб-интерфейс, но и напрямую из ваших скриптов, сервисов и внутренних инструментов.
Проще говоря, Engee можно встроить в ваш инженерный контур как вычислительный сервис.
Что можно делать через внешний API
Через API вы можете:
🔹Запускать и останавливать сессии Engee программно
Без ручного входа в интерфейс — удобно для автоматизации и серверных сценариев.
🔹Выполнять команды языка моделирования удаленно
Например, запускать параметрические прогоны, тестовые сценарии или серии расчётов.
🔹Передавать файлы и забирать результаты
Загружать входные данные, выгружать результаты, архивировать проекты и расчетные пакеты.
🔹Интегрировать Engee в собственные системы
Встраивать расчёты в CI/CD, внутренние инструменты, веб-сервисы или скрипты автоматизации.
Для упрощения старта подготовлен пример на пример на Python с пользовательским классом EngeeManager, который показывает типовые сценарии работы с API. Его можно использовать как заготовку и адаптировать под свои задачи.
Авторизация: под разные сценарии
Поддерживаются два режима доступа:
🟡 Personal Access Token (PAT)
Подходит для скриптов, CI/CD, серверных сервисов и фоновых задач.
🟡 OAuth 2.0
Для веб- и десктопных приложений, где требуется интерактивная авторизация пользователя.
Асинхронное выполнение для долгих расчётов
Для задач, которые не укладываются в стандартный таймаут HTTP-запроса, доступен асинхронный режим:
– отправляете задание и получаете ID задачи;
– периодически проверяете статус;
– забираете результат после завершения.
Это удобно для многовариантных расчетов, оптимизации, серий имитационных прогонов и других тяжелых сценариев.
Практические сценарии
Вот несколько типовых применений, которые уже напрашиваются:
⭐ Регрессионное тестирование моделей
Автоматический прогон тестов после каждого коммита.
⭐ Сервисы на базе цифровых двойников
Загрузка данных → расчёт в Engee → возврат прогнозов или характеристик.
⭐ Облачная расчётная лаборатория
Интеграция с LMS или внутренними порталами для проверки и выполнения инженерных заданий.
⭐ Инженерные боты и планировщики
Автоматический запуск сессий, подготовка окружения, ночные прогоны и пакетные расчёты.
Внешний API превращает Engee из «среды в браузере» в полноценный вычислительный компонент, который можно встроить в инженерную инфраструктуру и процессы автоматизации.
Документация по API доступна тут, примеры — в Сообществе Engee. Если вы уже используете API — будет полезно поделиться сценариями и практиками.
2 минуты
23 января