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

Позволяет получить внутренние числовые идентификаторы (кэш-ID) архивных параметров по их полным путям или узловым идентификаторам. Идентификаторы используются в дальнейших запросах на чтение данных.

HTTP: POST /Methods/GetArchiveItems

Запрос

{
  "sessionId": 1234,
  "items": [
    {
      "taskId": 0,
      "itemId": 111,
      "path": "",
      "typeHash": 4
    }
  ]
}

Поля запроса

Поле	Тип	Обязат.	По умолчанию	Описание
sessionId	int	Да		Идентификатор сессии.
items	array	Да		Массив запрашиваемых параметров.
items[].taskId	int	Нет	-1	Id задачи, которой принадлежит параметр.
items[].itemId	int64	Нет	0	Числовой идентификатор параметра.
items[].path	string	Нет	""	Дополнительный путь внутри сложного типа.
items[].typeHash	int	Нет	10	Хэш типа (соответствует OPC UA типу).

Ответ

{
  "items": [
    {
      "statusCode": 0,
      "archiveItemId": 1,
      "fullName": "Объекты.Объект 1.Параметр 1",
      "type": "LREAL",
      "startTime": 1690416372000,
      "endTime": 1690616372000,
      "decription": "Описание",
      "comment": "Комментарий",
      "scaleAI": {
        "min": 0.0,
        "max": 100.0,
        "unit": "°C"
      }
    }
  ],
  "serverTime": 1682503946407,
  "code": 0
}

Поля ответа

Поле	Тип	Условие	Описание
items	array	Всегда	Массив ответов по каждому параметру в порядке запроса.
items[].statusCode	uint	Всегда	Код успешности (0 = OpcUa_Good).
items[].archiveItemId	int64	Всегда	Cache ID параметра для HistoryReadRaw. -1, если параметр не архивируется.
items[].fullName	string	Параметр найден	Полное дерево проекта для параметра.
items[].type	string	Параметр найден	Имя ST-типа параметра.
items[].startTime	int64	Найден в кэше	Время первой доступной записи в архиве.
items[].endTime	int64	Найден в кэше	Время последней доступной записи в архиве.
items[].decription	string	Задано	Описание параметра из редактора (внимание на опечатку в коде: decription).
items[].comment	string	Задано	Комментарий параметра из редактора.
items[].scaleAI	object	Есть шкала AI	Настройки аналоговой шкалы.
items[].scaleDI	object	Есть шкала DI	Настройки дискретной шкалы.