RU

Основные запросы

Получить список сценариев автоматизации

Запрос:

GET /api/v1/automatons

Ответ:

Массив всех сценариев автоматизации проекта, включающий в себя следующую информацию об автоматах:

  • идентификатор;
  • имя;
  • описание;
  • выбранные модели

Получить информацию об одном сценарии автоматизации

Запрос:

GET /api/v1/automatons/:id

Ответ:

Представление сценария автоматизации в формате JSON, включающее в себя

  • идентификатор;
  • имя;
  • описание;
  • выбранные модели;
  • инфорацию о построенных состояниях и переходах

Создать новый сценарий автоматизации

В теле запроса на создание нового сценария автоматизации укажите его представление в формате JSON.

Обязательные поля:

  • model - идентификатор модели;
  • name - имя нового сценария автоматизации.

Запрос:

POST /api/v1/automatons

{
  "model": "<model-id>",
  "name": "test-automaton-01",
  "description": "Automaton for sensor"
}

Ответ:

Представление сценария автоматизации в формате JSON

Изменить сценарий автоматизации

В теле запроса на изменение существующего сценария автоматизации укажите поля, которые нужно обновить.

Запрос:

PATCH /api/v1/automatons/:id

{
  "name": "test-automaton-02"
}

Ответ:

Представление сценария автоматизации в формате JSON с учетом измененных полей

Удалить сценарий автоматизации

Запрос:

DELETE /api/v1/automatons/:id

Ответ:

Представление удаленного сценария автоматизации в формате JSON

Выполнение сценариев автоматизации на объектах

💡

Важно: В запросах :id - идентификатор объекта, на котором нужно запустить автомат, :automaton - идентификатор запускаемого автомата. |

Запустить выполнение сценария автоматизации на объекте

Запрос:

POST /api/v1/objects/:id/automatons/:automaton/start

Ответ:

Информация о статусе и состоянии выполнения автомата на момент его запуска в формате JSON

Остановить выполнения сценария автоматизации на объекте

Запрос:

POST /api/v1/objects/:id/automatons/:automaton/stop

Ответ:

Информация о статусе и состоянии выполнения автомата на момент его остановки в формате JSON

Отправить событие в запущенный сценарий автоматизации

В теле запроса укажите идентификатор события, которое необходимо сгенерировать в автомате.

Обязательные поля:

  • event - идентификатор события.

Запрос:

POST /api/v1/objects/:id/automatons/:automaton/emit

{
  "event": "<event-id>"
}

Ответ:

Информация о статусе выполнения запроса

💡

Подсказка: Данный запрос аналогичен нажатию кнопки Сгенерировать событие в автомате, запущенном на объекте.