10. Связывание правила с группой устройств

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

В рамках примера группа устройств будет определяться классом, полученном на шаге Создание класса устройства.

Чтобы создать группу устройств, используйте метод POST front-api-srv/api/v1.0/rule/device-group.

Пример тела запроса:

1
{
2
    "name": "Группа устройств",
3
    "isValidationSkip": false,
4
    "types": [
5
      "00d00000-0ed0-0a0f-beb0-df0b000a0000"
6
    ]
7
}

После успешного выполнения запроса будет получен ответ, содержащий данные сохраненной группы. Полученное значение уникального идентификатора группы устройств потребуется для дальнейших действий.

Пример ответа:

1
{
2
    "id": "d82cf582-6a88-459d-8dce-02b3bbc1d87c",
3
    "name": "Группа устройств",
4
    "isValidationSkip": false,
5
    "types": [
6
      "00d00000-0ed0-0a0f-beb0-df0b000a0000"
7
    ]
8
}

Привязка группы устройств к правилу осуществляется с помощью метода POST /front-api-srv//api/v1.0/rule/rule-set/bind.

Тело запроса содержит следующие параметры:

Пример тела запроса:

1
{
2
    "ruleSetId": "17b894de-56bb-4dc6-97e6-8f3e0087ddff",
3
    "deviceGroupId": "d82cf582-6a88-459d-8dce-02b3bbc1d87c"
4
}

При успешном выполнении запроса будет получен ответ с кодом 200 ОК.

Для проверки работы правила можно выполнить запрос эмуляции передачи телеметрии для устройства с помощью метода POST /front-api-srv//api/v1.0/rule/put-telemetry.

Тело запроса содержит следующие параметры:

object “values”

Пример тела запроса:

1
{
2
    "deviceId": "000000b0-00ca-0000-00f0-0a0000000eb0",
3
    "classId": "00d00000-0ed0-0a0f-beb0-df0b000a0000",
4
    "values": {
5
        "rssi": 5
6
    }
7
}

При успешном выполнении запроса в ответе будет получен код 200 ОК. Установленное правило должно будет запустить действие на отправку уведомления пользователю.