Дії API Trigger

Дії для розбору вхідних webhook-запитів та повернення відповіді.

Приклад: Обробити Webhook та сповістити

Handle Webhook

Receive webhook, parse body, send notification

Event

API Trigger

body
headers
method

Object

Get

object
body
path
event
output

Telegram Bot

Send Message

chatId
{{vault.ADMIN_CHAT}}
text
output
ДіяОписВихід
Parse BodyРозібрати JSON-тіло запитуРозібраний об'єкт
Parse HeadersВитягнути HTTP-заголовкиОб'єкт заголовків
Parse QueryВитягнути параметри URL-запитуОб'єкт параметрів
Get MethodОтримати HTTP-метод (GET/POST/тощо)Рядок методу
Get PathОтримати шлях запитуРядок шляху
RespondНадіслати HTTP-відповідь і зупинити flow—

Respond

Respond повертає HTTP-відповідь виклику та зупиняє flow — нічого після неї не виконується. Розміщуйте побічні ефекти (сповіщення, логування) перед нею.

ВхідОпис
statusHTTP-код статусу (за замовчуванням 200)
bodyТіло відповіді — текст або JSON. Необов'язкове
headersЗаголовки відповіді як JSON-об'єкт

Запит виклику чекає, поки буде досягнуто Respond, до 25 секунд, після чого отримує 504 із history_uuid.

Відповіді без тіла

Згідно з RFC 9110, деякі коди статусу не можуть мати тіло відповіді. Коли ви обираєте такий код як статичний статус, редактор ховає поле body, і відповідь надсилається без тіла та без заголовка Content-Type:

Діапазон статусуТіло
1xx (Continue, Switching Protocols, …)ніколи
204 No Contentніколи
304 Not Modifiedніколи
будь-який інший (200, 404, 500, …)необов'язкове — залиште порожнім для порожнього тіла

Якщо статус задано динамічно (з попереднього кроку), поле body лишається доступним; під час виконання тіло все одно прибирається для 1xx/204/304 або коли воно порожнє. Content-Type за замовчуванням text/plain; charset=utf-8, коли тіло є, а ви його не вказали.

Приклад

Коли webhook потрапляє на один із ваших маршрутів, наприклад:

POST https://<subdomain>.api.fainflow.com/webhook?source=github
Authorization: Bearer fkey_…
Content-Type: application/json

{"event": "push", "repo": "my-app"}

Дії дають:

  • Parse Body → {"event": "push", "repo": "my-app"}
  • Parse Headers → {"content-type": "application/json"}
  • Parse Query → {"source": "github"}
  • Get Method → POST
  • Get Path → /webhook
  • Respond → повертає виклику, напр. 200 {"ok": true}