/Methods/GetIntegrityControlStatus

<< Click to Display Table of Contents >>

Navigation:  API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Пользователи >

/Methods/GetIntegrityControlStatus

Возвращает состояние и результат проверки целостности — по идентификатору процесса или по последней проверке.

HTTP: POST /Methods/GetIntegrityControlStatus

Право: не проверяется.

Запрос

{ "processId": "01d39b7b-9b43-458b-88d6-7839cd363327" }

Поля запроса

Поле

Тип

Обязательное

По умолчанию

Описание

processId

string

нет

""

Идентификатор процесса из StartIntegrityControl; при отсутствии берётся последний результат

checkType

string

нет

последний тип

"system" или "project"; используется, когда processId не задан

Ответ

{
  "status": "completed",
  "result": [
    {
      "fileName": "./nginx/conf/nginx-mplc.conf",
      "checkSumFlag": false,
      "checkSum": "6561be249383f60f41b6edcf4f30cf9e",
      "etalonCheckSum": "115d31605796a16c5de5856cbd2ef09d"
    },
    {
      "fileName": "./aggregation.dll",
      "checkSumFlag": true,
      "checkSum": "4d403b580930ea3c593de8805720f4c3",
      "etalonCheckSum": "4d403b580930ea3c593de8805720f4c3"
    }
  ],
  "completionTime": 1757493800000,
  "code": 0
}

Поля ответа

Поле

Тип

Условие

Описание

status

string

всегда

"inProgress", "completed" или "failed"

result

array

завершено/ошибка и есть результаты

Список проверенных файлов

result[].fileName

string

в записи

Путь к файлу

result[].checkSumFlag

bool

в записи

true — контрольная сумма совпала с эталоном

result[].checkSum

string

сумма непустая

Вычисленная контрольная сумма

result[].etalonCheckSum

string

эталон непустой

Эталонная контрольная сумма

completionTime

integer

завершено/ошибка и есть результаты

Время завершения, Unix time в миллисекундах

errorText

string

status: "failed" и текст непуст

Причина ошибки проверки

code

integer

всегда

Результат метода

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

Недопустимый checkTypeOpcUa_BadInvalidArgument; неизвестный processId, отсутствие последней проверки или её результата — OpcUa_BadNotFound с соответствующим errorText.