Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Добавлено описание параметра interval

...

Code Block
languagetext
titlePOST
http://<server_address>/jobs?session=<session_token_id>&pointId=<point_id_value>&interval=<interval_value>

Данный метод запускает задачу опроса ресурса объекта учёта.

Запрос

Параметры запроса

Имя параметраТип данныхОписаниеОбязательный
sessionUUIDИдентификатор токена сессииДа
pointIdint32Идентификатор ресурсаДа
intervalint32Интервал опроса в секундах

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

Note
titleВнимание

Если интервал опроса задан менее 30 минут (1800 секунд) и вычитываемое значение на устройстве не меняется, то задача не будет возвращать никаких данных.


Ответы сервера

Viewport Tabs Container
Viewport Tab
title200

Данный код возвращается в том случае, если получилось запустить задачу.

Code Block
languagejs
titleПример ответа
{
  "Id": "string",
  "PointId": 0
}

 Описания полей

Имя поляТип данныхОписаниеОбязательный
IdUUIDИдентификатор задачиДа
PointIdint32Идентификатор ресурсаДа


Viewport Tab
title401

Данный код возвращается в том случае, если не был передан токен сессии.

Viewport Tab
title405

Данный код возвращается в том случае, если не был указан идентификатор ресурса.