API Trigger Connection

Зробіть будь-який flow аутентифікованим HTTP-ендпоїнтом. Зовнішній сервіс викликає ваш URL з API-ключем, flow виконується, а відповідь формує сам flow.

Налаштування

1. У Fainflow: Підключення → + Нове підключення → API Trigger
2. Після збереження ви отримаєте:
   • персональний ендпоїнт на випадковому субдомені — https://<subdomain>.api.fainflow.com
   • перший API-ключ, показаний один раз (скопіюйте зараз — відновити неможливо)
   • готовий маршрут api-trigger-test із прикладом flow (лише для читання)

New Connection

Name

Description

CancelSave

Аутентифікація

Кожен запит має містити активний ключ у заголовку Authorization:

Authorization: Bearer fkey_xxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxx

Ключ перевіряється на edge. Кожен ключ належить одному підключенню й працює лише на його субдомені. Тримайте кілька активних ключів під час ротації: створіть новий, переключіть клієнт, потім видаліть старий.

Маршрути (Routes)

Підключення може мати кілька маршрутів — кожен маршрут це шлях, що відповідає рівно одному flow:

https://<subdomain>.api.fainflow.com/<route>

Створюйте маршрути в деталях підключення, потім прив'яжіть flow до маршруту в події API Trigger редактора flow (випадаючий список). Розгалужуйте запит усередині flow за допомогою If / Else if.

Event

API Trigger — спрацьовує, коли запит потрапляє на прив'язаний маршрут.

Виходи event

Відповідь

Додайте дію Respond, щоб повернути HTTP-відповідь виклику. Вона задає статус, тіло й заголовки, після чого зупиняє flow — усе після неї не виконується. Запит виклику чекає, поки буде досягнуто Respond, до 25 секунд; після цього він отримує 504 із history_uuid для пошуку запуску.

Приклад

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

Помилки

Ліміти

Запити обмежені per-key та per-flow (100 / хвилину за замовчуванням). Понад ліміт повертається 429 із заголовком Retry-After.

Відкликання ключа

Видалення API-ключа відкликає його миттєво — наступний запит із ним поверне 401. Якщо канал відкликання тимчасово недоступний, ключ перестане діяти протягом ~60 секунд.