Integration Overview

Навігація

1. Як працює інтеграція в DEV платформі
2. Типи Flows та їх призначення
3. Візуальна структура інтеграції
4. Ключові принципи роботи

Як працює інтеграція в DEV платформі

─────────────────────────────────────────────────────────────-

Інтеграція в DEV-платформі — це структурована послідовність потоків (Flows), кожен з яких відповідає за конкретний етап обробки даних: від перевірки прав доступу до формування фінальної відповіді.

Загальна механіка

Життєвий цикл запиту в інтеграції виглядає так:

1. Авторизація (Authentication) ➔ 2. Валідація акаунту (Account Validation) ➔ 3. Обробка входу (Input) ➔ 4. Формування виходу (Output)  ➔ 5. Основна логіка (Main Action)

Разом вони формують єдину послідовну механіку роботи.

Типи Flows та їх призначення

─────────────────────────────────────────────────────────────-

Нижче наведено перелік усіх потоків, з яких будується інтеграція. Кожен Flow — це ізольоване робоче середовище зі своїм набором блоків.

Authentication Налаштування параметрів авторизації (API Key, OAuth2.0, Bearer). Визначає, як платформа підключається до зовнішнього сервісу.

Account Validation Логічна перевірка успішного підключення. Використовується для підтвердження того, що надані дані авторизації є валідними.

Input Первинна обробка вхідних даних від користувача або зовнішньої системи. Тут відбувається підготовка параметрів для основного запиту.

Main Action "Серце" інтеграції. Виконання головних запитів до API, складна бізнес-логіка, цикли (Loop) та обчислення (Evaluate).

Output Фінальний етап. Формування структури даних, яку отримає кінцевий споживач інтеграції. Нормалізація результату.

Request Error Глобальний обробник помилок. Виконується автоматично, якщо на будь-якому етапі виникла помилка запиту.

Custom Flows Допоміжні, багаторазові під-процеси. Створюються для винесення повторюваної логіки, щоб не дублювати її в основних потоках.

Візуальна структура інтеграції

─────────────────────────────────────────────────────────────-

У цьому розділі показано, як виглядають налаштовані потоки в робочому середовищі.


Authentication: Конфігурація полів авторизації та ключів доступу.


Account Validation: Перевіряє коректність статусу підключення перед виконанням дій.


Input: Приймає та готує вхідні параметри перед основною логікою.


Main Action: Виконує основні API-запити та бізнес-логіку інтеграції.


Output: Формує фінальний результат для користувача або зовнішньої системи.


Request Error: Активується автоматично при помилках запиту.

Ключові принципи роботи

─────────────────────────────────────────────────────────────-

1. Послідовність виконання: Потоки виконуються один за одним (за винятком Custom та Error Flows, які викликаються за потреби).
2. Передача даних: Дані, отримані в одному Flow, можуть передаватися далі через об'єкт глобальних змінних (VARS) або через результати виконання попередніх кроків.
3. Ізоляція помилок: Якщо помилка стається всередині конкретного Flow і не обробляється локально, управління передається в Request Error Flow (якщо підключено Error Flow в блоці HTTP Request).
4. Модульність: Завдяки розділенню на різні типи потоків, ви можете окремо дебажити авторизацію, не запускаючи основну логіку обробки даних.

Що далі?

─────────────────────────────────────────────────────────────-

Ви ознайомилися зі структурою інтеграції та основними флоу, з яких вона складається.

Наступний крок налаштування:
Authentication Flow →
На цьому етапі ви підключите зовнішній сервіс і налаштуєте авторизацію запитів.