http://<server_address>/jobs?session=<session_token_id>&pointId=<point_id_value>&interval=<interval_value> |
Данный метод позволяет запустить задачу на чтение или запись заданного параметра ресурса объекта учёта.
Задание на чтение параметра ресурса
Параметры запроса
Имя параметра | Тип данных | Описание | Обязательный |
---|
session | UUID | Идентификатор токена сессии | Да |
pointId | int32 | Идентификатор параметра ресурса | Да |
interval | int32 | Интервал опроса в секундах |
|
Под интервалом опроса подразумевается с какой периодичностью задание будет обновлять данные (опрашивать устройство). Если значение интервала указано 0 секунд, то опрос будет произведен однократно и задача завершится автоматически. Если же интервал отличен от нуля, то для завершения задания необходимо отправить команду отмены вручную.
Если интервал опроса задан менее 30 минут (1800 секунд) и вычитываемое значение на устройстве не меняется, то задача не будет возвращать никаких данных. |
Задание на запись параметра ресурса
Параметры запроса
Имя параметра | Тип данных | Описание | Обязательный |
---|
session | UUID | Идентификатор токена сессии | Да |
pointId | int32 | Идентификатор параметра ресурса | Да |
Параметры тела запроса
Записываемое значение передается в теле запроса в виде JSON-объекта следующей структуры:
{
"Value": <значение для записи>
} |
Ответы сервера
Данный код возвращается в том случае, если получилось запустить задачу. {
"Id": "string",
"PointId": 0
} |
Описания полейИмя поля | Тип данных | Описание | Обязательный |
---|
Id | UUID | Идентификатор задачи | Да | PointId | int32 | Идентификатор ресурса | Да |
|
Данный код возвращается в том случае, если не был передан токен сессии. |
Данный код возвращается в том случае, если не был указан идентификатор ресурса. |
|