Триггер по вебхуку
Описание узла
Триггер по вебхуку — триггер-узел, который служит точкой входа в сценарий. Запросы отправляются на URL узла Триггер по вебхуку, инициируя выполнение сценария.
Настройка узла
После добавления узла Триггер по вебхуку автоматически генерируются две версии его URL. Обе версии URL отображаются в поле Path:
- Production-версия доступна по нажатию на Production URL. Запросы на эту версию URL могут отправляться непрерывно, и выполнение сценария не прекратится, пока сценарий не будет остановлен вручную или не произойдёт критическая ошибка.
- Development-версия доступна по нажатию на Development URL. Отправка запроса на эту версию URL запускает сценарий один раз, после чего сценарий прекращает работу. Это полезно для тестирования и временной отладки сценария без длительного выполнения.
Сгенерированный URL можно либо частично изменить (1), либо скопировать (2) для последующего включения в запрос, отправляемый для запуска сценария.
Вы можете отправлять запросы на адрес узла Триггер по вебхуку методом POST (если необходимо передать данные в узел) или методом GET (если требуется простой запуск узла).
Варианты ответа вебхука
На запрос вебхука платформа может отвечать тремя способами:
-
Ответ по умолчанию (
200 OK)
Если в сценарии не используется узел Ответ вебхуку, платформа сразу вернёт200 OKи примет запрос. Если достигнут лимит параллельных выполнений, сценарий всё равно выполнится, когда дойдёт его очередь. -
Кастомный ответ через Ответ вебхуку
Если вы добавите узел Ответ вебхуку, вы сможете вернуть свой ответ: например, изменить тело, статус и заголовки. Ответ уйдёт только когда узел отработает. Если запуск стоит в очереди из-за лимита параллельных выполнений, отправитель может не дождаться ответа из-за своего таймаута. -
Мгновенный ответ (fast mode)
Если отправителю нужен ответ сразу (например, из‑за короткого таймаута), включите fast mode через параметры URL.
Fast mode (асинхронный режим)
Fast mode: это режим, в котором вебхук работает асинхронно, то есть отвечает сразу, не дожидаясь выполнения сценария. Он полезен, если отправитель ждёт ответ очень быстро и может разорвать соединение раньше.
__ln.fast=1 — fast mode
Параметр __ln.fast=1 включает быстрый режим: вебхук возвращает ответ сразу, не дожидаясь выполнения сценария. В этом режиме узел Ответ вебхуку не используется для ответа вебхуку (он не сработает), потому что ответ уже отправлен сервису‑отправителю.
Важно
- В fast mode клиент, который отправляет запрос, может не увидеть ошибку сценария, например, если сценарий неактивен и т. д.
- Даже если вебхук не существует и для запроса с параметром
__ln.fast=1не найден, платформа всё равно вернёт200 OK.
Доступные параметры __ln.*
| Параметр | Что делает | Пример значения |
|---|---|---|
__ln.fast | Включает fast mode: Nodul отвечает сразу (до выполнения сценария). | __ln.fast=1 |
__ln.resp.body | Тело ответа для async случая (нет Ответ вебхуку или включён __ln.fast=1). | __ln.resp.body=Hello%20World |
__ln.resp.status | HTTP‑статус ответа для async случая. | __ln.resp.status=201 |
__ln.resp.header.<header> | Заголовок ответа для async случая. | __ln.resp.header.content-type=application/json |
Пример полного URL
https://<your-webhook-url>?__ln.fast=1&__ln.resp.body=Hello%20World&__ln.resp.status=201&__ln.resp.header.content-type=application/jsonНужна помощь? Спросите сообщество
Если на странице не хватает деталей или что-то непонятно, напишите на форуме сообщества Nodul: команда и другие пользователи обычно отвечают быстро.
Программное обеспечение распространяется в виде интернет-сервиса, специальные действия по его установке на стороне пользователя не требуются.