Set Validation Result
Set Validation Result — це ключовий блок флоу Account Validation, який визначає успішність перевірки акаунта користувача. Це «фінальна точка» валідації: саме цей блок повідомляє системі, чи можна пропускати користувача до наступних кроків інтеграції, чи його дані є невалідними.
Навігація
Призначення та розташування блоку
─────────────────────────────────────────────────────────────-
Цей блок є обов'язковим для флоу Account Validation. Без нього платформа не зможе отримати підтвердження, що акаунт працює коректно.
Блок не виконує запити й не перевіряє дані самостійно — він фіксує фінальний результат валідації, який формується на основі логіки, реалізованої в інших блоках (зазвичай через IF).
Як додати Account Validation:
- У правій частині DEV-платформи натисніть на іконку меню (3 риски).
- Оберіть пункт Add Flow.
- Виберіть тип флоу — Validation.
Після цього всередині флоу ви зможете розмістити блок Set Validation Result, це фінальний блок, який завершує логіку перевірки.
Налаштування блоку
─────────────────────────────────────────────────────────────-
Блок має два основних параметри, які визначають долю поточної сесії:
1 -> Validation Status: визначає фінальний статус акаунта (приймає 1 або 0):
- 1 - акаунт валідний або дані оброблені платформою
- 0 - акаунт вважається невалідним і не може бути використаний
2 -> Validation Error: необов'язкове текстове поле для опису причини невдачі. Можна прописати статичний текст (наприклад: "Invalid API key") або вставити динамічну змінну з відповіді сервера API, щоб користувач розумів конкретну причину помилки.
3 -> Перемикач режиму полів TXT / EXP: Обидва поля підтримують перемикання між простим текстом та виразами. Це дозволяє, наприклад, динамічно виставляти статус залежно від коду відповіді API.
Простий варіант (TXT режим) - все обробляється як текст.
Просунутий варіант (EXP режим) - вміст обробляється як повноцінний вираз (Expression). Дозволяє застосувати логічні оператори та функції безпосередньо в полі вибору. Наприклад, «/» у режимі TXT - це роздільник, а в режимі EXP - ділення.
Логіка роботи: Зв'язок з блоком IF
─────────────────────────────────────────────────────────────-
Блок Set Validation Result практично ніколи не використовується наодинці. Його завдання — зафіксувати результат перевірки, яку зазвичай виконує блок IF.
Типова архітектура валідації:
1 -> HTTP Request: Виконується тестовий запит до API (наприклад, /me або /profile).
2 -> IF : Перевіряє отримані дані. Чи існує у відповіді певний об'єкт або поле, що підтверджує успіх (наприклад, id_user, data)
3 -> Гілка True: Встановлюється блок Set Validation Result зі статусом 1.
4 -> Гілка False: Встановлюється блок Set Validation Result зі статусом 0 та описом помилки з відповіді API.
FAQ
─────────────────────────────────────────────────────────────-
1. Що станеться, якщо у флоу валідації не буде цього блоку? Платформа не отримає чіткого сигналу про успіх або помилку. Це може призвести до того, що інтеграція "зависне" або видасть системну помилку, навіть якщо дані акаунта вірні.
2. Чи можна використовувати кілька таких блоків в одному флоу?
Так. Це стандартна практика. Ви можете мати один блок для успішної валідації та кілька різних блоків для різних типів помилок (наприклад: "Акаунт заблоковано", "Вичерпано ліміт запитів", "Невірні права доступу").
3. Чи побачить кінцевий користувач текст із поля Validation Error?
Так, якщо статус встановлено на 0, текст помилки буде відображений користувачу в інтерфейсі інтеграції.
4. Чи можна передати статус 1, але при цьому записати текст у Validation Error?
Технічно так, але зазвичай це не має сенсу. Поле помилки ігнорується системою, якщо статус успіху дорівнює 1.
5. Чи можна виставляти Validation Status через EXP?
Так. Це зручно, коли статус залежить від логічної перевірки або відповіді API.
6. Чи обовʼязково заповнювати Validation Error?
Ні, але рекомендується для кращого UX і зрозумілих повідомлень про помилки.