API MasterSCADA 4D > Подключение к исполнительной системе по JSON > HTTP API MasterPLC > Доступ к архивам данных

Синхронное чтение сырых исторических данных. Если запрошенный объем превышает максимальный (или numValuesPerNode), сервер вернет часть данных и статус наличия продолжения.

HTTP: POST /Methods/HistoryReadRaw

Запрос

{
  "sessionId": 1234,
  "parameters": {
    "startTime": 1357002062000,
    "endTime": 1357002062000,
    "numValuesPerNode": 1000,
    "returnBounds": true,
    "returnFirstLastValue": false,
    "resampleInterval": 0.0
  },
  "data": [
    {
      "archiveItemId": 111,
      "continuationPoint": 0
    }
  ]
}

Поля запроса

Поле	Тип	Обязат.	По умолчанию	Описание
parameters.startTime	int64 / string	Да		Время начала интервала (в мс или строка).
parameters.endTime	int64 / string	Да		Время окончания интервала.
parameters.returnFirstLastValue	bool	Нет	false	Вернуть только первое и последнее значение интервала.
parameters.resampleInterval	double	Нет	0.0	Интервал прореживания (в мс).
parameters.returnBounds	bool	Нет	false	Возвращать ли значения, прилегающие к границам.
parameters.numValuesPerNode	uint	Нет	MAX/Size	Максимальное количество записей на узел в ответе.
data	array	Да		Массив запрашиваемых узлов архива.
data[].archiveItemId	int64	Да		archiveItemId, полученный из GetArchiveItems.
data[].continuationPoint	int64	Нет	0	Метка времени для продолжения чтения (точка продолжения).

Ответ

{
  "data": [
    {
      "archiveItemId": 111,
      "areMoreValues": true,
      "continuationPoint": 1357002092000,
      "values": [
        [1357002072000, 12.0, 0],
        [1357002082000, 13.0, 0],
        [1357002092000, 14.0, 0]
      ]
    }
  ],
  "serverTime": 1682503946407,
  "code": 2147483648
}

Поля ответа

Поле	Тип	Условие	Описание
data	array	Всегда	Массив ответов по узлам архива.
data[].archiveItemId	int64	Всегда	Идентификатор параметра архива.
data[].statusCode	uint	При ошибке узла	Код ошибки, если получить данные не удалось.
data[].areMoreValues	bool	Успешно	Флаг наличия дополнительных данных (статус OpcUa_GoodMoreData).
data[].continuationPoint	int64	Успешно	Точка продолжения (время), передаваемая в следующий запрос. Формат — int64 (число, в старой справке ошибочно указана строка).
data[].values	array	Успешно	Массив массивов [time, value, quality].
code	uint	Корневой код	Если хоть один узел вернул флаг продолжения, вернется код 2147483648 (OpcUa_GoodMoreData).