Webhooks/ru - Revision history

Mark: ru

2026-11-05T12:38:00Z

Mark: ru

2026-11-05T12:37:59Z

Mark: ru

2026-11-05T12:37:59Z

Mark: ru

2026-11-05T12:37:58Z

Mark: ru

2026-11-05T12:37:57Z

Mark: ru

2026-11-05T12:37:57Z

Mark: ru

2026-11-05T12:37:56Z

Mark: ru

2026-11-05T12:37:55Z

New page

<languages/>
'''Webhooks''' connect the Larnitech system with any internet service that can send or receive HTTP requests (for example [[IFTTT (IF This, Then That)|IFTTT]]). They are set up in LT Setup on the '''Webhooks''' tab, which has two parts:
* '''Events''': the Larnitech server sends an HTTP request to an external URL when something happens in the system.
* '''Actions''': an external service sends an HTTP request to the Larnitech server, and the server changes the state of an item.

== Events ==
An event has the following fields:
{|class="wikitable"
!Field!!Description
|-
|Name||Name of the event. It is used in the script that sends the event.
|-
|URL||Address that the server calls.
|-
|Method||<code>GET</code> (default) or <code>POST</code>.
|-
|Feedback||Optional. Item address and a regular expression: the value found in the answer is written to that item.
|}
The event is sent from a script. In LT Setup open '''Scripts → Scripts from logic → Add Blockly script''', add the device event on the '''Triggers''' tab, put the '''Make webhook''' block from the '''Automation''' tab into it and choose the event name.

== Actions ==
An action has a name, an item and the state to set (on, off, reverse, level, mode, target temperature and so on, depending on the item type).

To run an action, call the URL:
* in the local network: <code><nowiki>http://CONTROLLER_IP/webhook/?key=API_KEY&name=ACTION_NAME</nowiki></code>
* over the internet: <code><nowiki>https://service.larnitech.com/webhook/?key=API_KEY&sn=SERIAL&name=ACTION_NAME</nowiki></code>
where:
* <code>API_KEY</code>: API key of the server (the <code>TCP-API</code> key, see [[API2]]);
* <code>SERIAL</code>: serial number of the server;
* <code>ACTION_NAME</code>: name of the action from the '''Name''' field.

The server answers with JSON. An error answer has <code>"result":"ERROR"</code> and a message, for example <code>Error Key</code> (wrong key) or <code>Action not found</code>.

== Example ==
The settings are stored in <code>/home/settings/webhooks.json</code>. Example with one event with feedback and two actions:
<syntaxhighlight lang="json" line>
{
"events": [
{
"name": "997:1_button_pressed",
"url": "https://maker.ifttt.com/trigger/997:1_button_pressed/with/key/YOUR_IFTTT_KEY",
"method": "POST"
},
{
"name": "447:145_sensor_state",
"url": "https://example.com/weather.json",
"feedback": { "addr": "447:145", "regexp": "/\"temp\":\"(-?[0-9]+)\",/" }
}
],
"actions": [
{
"name": "401:1_lamp_on",
"status": [ { "request": "status-set", "addr": "401:1", "status": { "state": "on" } } ]
},
{
"name": "401:1_lamp_reverse",
"status": [ { "request": "status-set", "addr": "401:1", "status": { "state": "reverse" } } ]
}
]
}
</syntaxhighlight>

See also: [[IFTTT (IF This, Then That)]], [[API2]].

← Older revision		Revision as of 12:38, 5 November 2026
Line 61:		Line 61:
	</syntaxhighlight>		</syntaxhighlight>

−	~~See also~~: [[IFTTT (IF This, Then That)]], [[API2]].	+	См. также: [[IFTTT (IF This, Then That)]], [[API2]].

@@ Line 32: / Line 32: @@
 Сервер отвечает в формате JSON. При ошибке в ответе <code>"result":"ERROR"</code> и сообщение, например <code>Error Key</code> (неверный ключ) или <code>Action not found</code>.
-== Example ==
+== Пример ==
-The settings are stored in <code>/home/settings/webhooks.json</code>. Example with one event with feedback and two actions:
+Настройки хранятся в файле <code>/home/settings/webhooks.json</code>. Пример с событием с обратной связью и двумя действиями:
 <syntaxhighlight lang="json" line>
+{

@@ Line 30: / Line 30: @@
 * <code>ACTION_NAME</code>: название действия из поля '''Name'''.
-The server answers with JSON. An error answer has <code>"result":"ERROR"</code> and a message, for example <code>Error Key</code> (wrong key) or <code>Action not found</code>.
+Сервер отвечает в формате JSON. При ошибке в ответе <code>"result":"ERROR"</code> и сообщение, например <code>Error Key</code> (неверный ключ) или <code>Action not found</code>.
 == Example ==

@@ Line 22: / Line 22: @@
 У действия есть название, элемент и состояние, которое нужно установить (включить, выключить, переключить, уровень, режим, целевая температура и т. д., в зависимости от типа элемента).
-To run an action, call the URL:
+Чтобы выполнить действие, обратитесь по адресу:
-* in the local network: <code><nowiki>http://CONTROLLER_IP/webhook/?key=API_KEY&name=ACTION_NAME</nowiki></code>
+* в локальной сети: <code><nowiki>http://CONTROLLER_IP/webhook/?key=API_KEY&name=ACTION_NAME</nowiki></code>
-* over the internet: <code><nowiki>https://service.larnitech.com/webhook/?key=API_KEY&sn=SERIAL&name=ACTION_NAME</nowiki></code>
+* через интернет: <code><nowiki>https://service.larnitech.com/webhook/?key=API_KEY&sn=SERIAL&name=ACTION_NAME</nowiki></code>
-where:
+где:
-* <code>API_KEY</code>: API key of the server (the <code>TCP-API</code> key, see [[API2]]);
+* <code>API_KEY</code>: ключ API сервера (ключ <code>TCP-API</code>, см. [[API2]]);
-* <code>SERIAL</code>: serial number of the server;
+* <code>SERIAL</code>: серийный номер сервера;
-* <code>ACTION_NAME</code>: name of the action from the '''Name''' field.
+* <code>ACTION_NAME</code>: название действия из поля '''Name'''.
 The server answers with JSON. An error answer has <code>"result":"ERROR"</code> and a message, for example <code>Error Key</code> (wrong key) or <code>Action not found</code>.

@@ Line 19: / Line 19: @@
 Событие отправляется из сценария. В LT Setup откройте '''Scripts → Scripts from logic → Add Blockly script''', на вкладке '''Triggers''' добавьте событие устройства, поместите в него блок '''Make webhook''' с вкладки '''Automation''' и выберите название события.
-== Actions ==
+== Действия ==
-An action has a name, an item and the state to set (on, off, reverse, level, mode, target temperature and so on, depending on the item type).
+У действия есть название, элемент и состояние, которое нужно установить (включить, выключить, переключить, уровень, режим, целевая температура и т. д., в зависимости от типа элемента).
 To run an action, call the URL:

@@ Line 4: / Line 4: @@
 * '''Actions''' (действия): внешний сервис отправляет HTTP-запрос серверу Larnitech, и сервер меняет состояние элемента.
-== Events ==
+== События ==
-An event has the following fields:
+Поля события:
 {|class="wikitable"
-!Field!!Description
+!Поле!!Описание
 |-
-|Name||Name of the event. It is used in the script that sends the event.
+|Name||Название события. По нему событие вызывается из сценария.
 |-
-|URL||Address that the server calls.
+|URL||Адрес, на который обращается сервер.
 |-
-|Method||<code>GET</code> (default) or <code>POST</code>.
+|Method||<code>GET</code> (по умолчанию) или <code>POST</code>.
 |-
-|Feedback||Optional. Item address and a regular expression: the value found in the answer is written to that item.
+|Feedback||Необязательно. Адрес элемента и регулярное выражение: найденное в ответе значение записывается в этот элемент.
 |}
-The event is sent from a script. In LT Setup open '''Scripts → Scripts from logic → Add Blockly script''', add the device event on the '''Triggers''' tab, put the '''Make webhook''' block from the '''Automation''' tab into it and choose the event name.
+Событие отправляется из сценария. В LT Setup откройте '''Scripts → Scripts from logic → Add Blockly script''', на вкладке '''Triggers''' добавьте событие устройства, поместите в него блок '''Make webhook''' с вкладки '''Automation''' и выберите название события.
 == Actions ==

@@ Line 1: / Line 1: @@
 <languages/>
-'''Webhooks''' connect the Larnitech system with any internet service that can send or receive HTTP requests (for example [[IFTTT (IF This, Then That)|IFTTT]]). They are set up in LT Setup on the '''Webhooks''' tab, which has two parts:
+'''Webhooks''' связывают систему Larnitech с любым интернет-сервисом, который умеет отправлять или принимать HTTP-запросы (например, [[IFTTT (IF This, Then That)|IFTTT]]). Они настраиваются в LT Setup на вкладке '''Webhooks''', у которой две части:
-* '''Events''': the Larnitech server sends an HTTP request to an external URL when something happens in the system.
+* '''Events''' (события): сервер Larnitech отправляет HTTP-запрос на внешний адрес, когда в системе что-то происходит.
-* '''Actions''': an external service sends an HTTP request to the Larnitech server, and the server changes the state of an item.
+* '''Actions''' (действия): внешний сервис отправляет HTTP-запрос серверу Larnitech, и сервер меняет состояние элемента.
 == Events ==