API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > События и сообщения

Квитирует события по eventId и возвращает отдельный результат для каждой записи.

HTTP: POST /Methods/AcknowledgeEvents

Запрос

{
  "sessionId": 123456789,
  "recs": [
    {
      "eventId": "12A5EDFFFFFF",
      "comment": "Проверено оператором"
    },
    {
      "eventId": "13A5EDABABAB"
    }
  ]
}

Поля запроса

Поле	Тип	Обязательное	По умолчанию	Описание
sessionId	integer	условно	—	Нужен, если сессия не передана заголовком Session-Id
recs	array	да	—	Массив квитируемых событий
recs[].eventId	string	да	""	Идентификатор события, полученный из EventId
recs[].comment	string	нет	""	Комментарий оператора
subscriptionId	integer	нет	—	Устаревшее поле: обработчик его не читает
recs[].monitoredItemId	integer	нет	—	Устаревшее поле: обработчик его не читает

Ответ

{
  "recsStatus": [0, 2157838336],
  "serverTime": 1710000000123,
  "code": 0
}

Поля ответа

Поле	Тип	Описание
recsStatus	array of integer	Результаты квитирования в порядке recs
serverTime	integer	Время сервера, Unix time в миллисекундах
code	integer	Общий результат разбора массива; обычно 0, даже если отдельные квитирования не выполнены

Поведение и ограничения

•Метод не проверяет subscriptionId и не требует, чтобы событие было получено через текущую подписку.

•Имя пользователя и адрес клиента для аудита берутся из действующей HTTP-сессии, а не из тела запроса.

•Неизвестный или неразбираемый eventId даёт OpcUa_BadDataUnavailable в соответствующем элементе recsStatus.

•Уже квитированное сообщение может вернуть OpcUa_BadConditionBranchAlreadyAcked. Для исторической ветви, которую нельзя квитировать как текущую, обработчик пытается добавить отдельную архивную запись квитирования.

•Корневой code: 0 означает, что массив обработан, а не то, что все элементы recsStatus равны 0.

•Текущая реализация ожидает массив объектов; передача другой структуры не является поддержанным контрактом.