Skip to content
На этой странице:

9. Создание правила для запуска действия

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

Для создания правила используйте метод POST /front-api-srv/api/v1.0/rule.

ПараметрТипТип данныхОбяз.ОписаниеПример
conditionbodystring+Условия срабатывания правила:
":1 < 760.00 && :2 > 0".
:1 - первый элемент массива binds[].
"Бинды" (binds) характеризуют атрибуты, используемые в условиях правила.
Для биндов используются операторы сравнения. Условие может состоять из нескольких выражений, для связки используются логические операторы
:1 > 0
bindsbodyarray[object]+Связи-
actionIdbodystring+Идентификатор действияf1fb0ddd-1693-439b-a895-98ec74ca2e71

object "binds"

ПараметрТипТип данныхОбяз.ОписаниеПример
typebodystring+Тип. Возможные значения: factfact
valuebodystring+Значениеrssi

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

json
{
    "condition": ":1 > 0",
    "binds": [
        {
            "type": "fact",
            "value": "rssi"
        }
    ],
    "actionId": "f1fb0ddd-1693-439b-a895-98ec74ca2e71"
}

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

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

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

json
{
    "id": "17b894de-56bb-4dc6-97e6-8f3e0087ddff",
    "condition": ":1 > 0",
    "binds": [
        {
            "type": "fact",
            "value": "rssi"
        }
    ],
    "actionId": "f1fb0ddd-1693-439b-a895-98ec74ca2e71"
}