9. Создание правила для запуска действия
Чтобы отправка уведомления была успешной, необходимо сформировать правило для действия, полученного на шаге Создание действия для отправки уведомления. Правило определяет, при каком значении заданных параметров запускается действие. В качестве примера приведено правило для полученного значения телеметрии, превышающее 0
.
Для создания правила используйте метод POST /front-api-srv/api/v1.0/rule
.
Параметр | Тип | Тип данных | Обяз. | Описание | Пример |
---|---|---|---|---|---|
condition | body | string | + | Условия срабатывания правила: ":1 < 760.00 && :2 > 0". :1 - первый элемент массива binds[]. "Бинды" (binds) характеризуют атрибуты, используемые в условиях правила. Для биндов используются операторы сравнения. Условие может состоять из нескольких выражений, для связки используются логические операторы | :1 > 0 |
binds | body | array[object] | + | Связи | - |
actionId | body | string | + | Идентификатор действия | f1fb0ddd-1693-439b-a895-98ec74ca2e71 |
object "binds"
Параметр | Тип | Тип данных | Обяз. | Описание | Пример |
---|---|---|---|---|---|
type | body | string | + | Тип. Возможные значения: fact | fact |
value | body | string | + | Значение | 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"
}