Account Validation Flow

Логічна перевірка валідності підключеного акаунту.

Account Validation — це окремий потік (Flow), який автоматично перевіряє дані акаунту (token, API key, secret тощо) і напряму пов’язаний з методом Authentication. Саме він визначає, чи може акаунт вважатися валідним та використовуватися в інтеграції в інших Flow.

Навігація

1. Як працює Account Validation.
2. Як додати та активувати Flow.
3. Типова структура перевірки Account Validation.
4. Ключові принципи роботи.
5. FAQ.

Як працює Account Validation

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

Цей потік запускається щоразу, коли користувач додає новий акаунт або намагається активувати існуючий. Результатом виконання завжди є Validation Status валідний (1) або невалідний (0), який визначає, чи може акаунт використовуватись у подальших Flow.

Важливо: Набір доступних змінних для перевірки динамічно змінюється залежно від методу авторизації, обраного в Authentication Flow. Наприклад, для Bearer перевірятиметься лише token, а для OAuth 2.0 відповідний access_token / refresh_token.

Як додати та активувати Flow

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

Account Validation не є частиною основної лінійної схеми, він знаходиться у бічній панелі керування:

1 -> відкриває бічну панель: це навігація по всім доступним фловам. 

2 -> кнопка Add Flow: додає окремий флоу Validation, який буде виконуватись під час перевірки акаунту. В бічній панелі ви можете додати лише один флоу валідації.

3 -> Validation: з'являється після натискання на кнопку Add Flow. Треба обрати його для налаштування.

4 -> перемикач увімкнення/вимкнення валідації: визначає, чи буде саме цей флоу використаний для валідації акаунту. 

Типова структура перевірки Account Validation

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

Найбільш поширена та рекомендована схема валідації в Dev платформі складається з таких кроків:

1 -> IF - перевірка заповненості даних: перевірка, чи ввів користувач обов'язкові дані при створенні акаунту (token, api key, api secret тощо).

2 -> Set Validation Result - зі статусом 0: якщо дані порожні (False) акаунт вже можна вважати невалідним, і буде статус (Validation Status) = 0 (помилка даних).

3 -> HTTP Request:  виконується перевірка реальної працездатності через запит до API системи (наприклад, метод /me, /profile або /ping). Мета — отримати відповідь, що підтверджує валідність.

4 -> IF - перевірка відповіді API: чи існує у відповіді певний об'єкт або поле, що підтверджує успіх (наприклад, id_user, data)

5 -> Set Validation Result - зі статусом 1: акаунт валідний або дані оброблені платформою (Validation Status = 1).

6 -> Set Validation Result - зі статусом 0: акаунт вважається невалідним і не може бути використаний  (Validation Status = 0).

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

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

• Ізоляція: Помилка в цьому Flow не зупиняє всю систему, але блокує можливість використання конкретного акаунту.
• Гнучкість: Ви можете налаштувати будь-яку кількість перевірок перед тим, як винести фінальний вердикт про валідність.
• Залежність: Структура цього Flow повинна завжди відповідати обраному методу в Authentication.
• Рекомендація: Використовуйте HTTP Request для реальної перевірки працездатності даних.

FAQ

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

1. Що буде, якщо не додати Account Validation?

Платформа не зможе автоматично перевіряти акаунти, що може призвести до помилок виконання в Main Action через невалідні токени.

2. Чи обов'язково використовувати HTTP Request у валідації?

Це рекомендовано. Без запиту до API ви перевіряєте лише факт заповнення полів, але не їхню реальну працездатність.

Що далі?

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

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

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

Попередній крок:
← Authentication Flow