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 | Идентификатор ресурса | Да |
Данный код возвращается в том случае, если не был передан токен сессии.
Данный код возвращается в том случае, если не был указан идентификатор ресурса.