Static headers

Static Headers — це сервісний блок, який автоматично додає задані HTTP-заголовки до кожного HTTP Request у межах дії інтеграції. Блок не виконує запитів і не змінює логіку флоу — він лише централізовано підставляє заголовки, щоб вам не потрібно було дублювати їх у кожному HTTP Request.

Навігація

1. Призначення та розташування
2. Налаштування блоку
3. Механізм роботи
4. Поєднання з блоком Custom
5. FAQ

Призначення та розташування

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

Блок знаходиться у флоу Authentication. Його головна задача — "прикріпити" специфічні технічні заголовки до кожного HTTP-запиту, який буде виконуватися в межах поточної інтеграції.

Як це працює:

1. Ви додаєте блок у Authentication Flow (зазвичай після основного блоку авторизації, наприклад Custom).
2. Прописуєте назви та значення необхідних заголовків.
3. Платформа автоматично "підмішує" ці заголовки у вкладку Headers кожного блоку HTTP Request у будь-якому флоу цієї дії.

Налаштування блоку

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

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

1 -> Name: Технічна назва заголовка, наприклад, Content-Type, X-Partner-ID, App-Version (підтримує перемикання режиму поля TXT / EXP).

2 -> Value: Значення заголовка. Тут можна писати як звичайний текст, так і вставляти динамічні змінні. (підтримує перемикання режиму поля TXT / EXP).

3 -> Кнопка + Add Item: Створює новий рядок для заголовка.

4 -> Перемикач режиму полів TXT / EXP:

Простий варіант (TXT режим) - все обробляється як текст.

Просунутий варіант (EXP режим) - вміст обробляється як повноцінний вираз (Expression). Дозволяє застосувати логічні оператори та функції безпосередньо в полі вибору. Наприклад, «/» у режимі TXT - це роздільник, а в режимі EXP - ділення.

Механізм роботи

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

Головна особливість блоку — глобальність. Він працює за принципом "налаштував один раз — працює скрізь". Якщо ви додали заголовок у Static Headers, вам не потрібно заходити в кожен блок HTTP Request і прописувати його вручну. Платформа зробить це за вас автоматично "під капотом".

Це не тільки економить час, але й запобігає помилкам: якщо назва заголовка зміниться, вам достатньо виправити її в одному місці (у блоці Static Headers), і зміни миттєво застосуються до всіх запитів.

Поєднання з блоком Custom (Рекомендовано)

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

Блок Static Headers є ідеальним доповненням до методу Custom Authentication. Оскільки блок Custom сам по собі не вміє передавати дані в запити, Static Headers стає тим самим "містком".

Приклад налаштування:

1 -> Блок Custom: Ви створюєте поля для користувача, наприклад, api_key та api_secret.

2 -> Блок Static Headers: Розміщуєте його одразу після Custom.

• Name: api_key — Value: {{account.api_key}} 

• Name: api_secret — Value: {{account.api_secret}}

3 -> Результат: Тепер кожен ваш запит до API буде автоматично містити ці два заголовки з реальними даними користувача.

FAQ

1. Чи можу я використовувати Static Headers без блоку авторизації?
Так. Якщо API не потребує складної авторизації, але вимагає передачі певних технічних заголовків (наприклад, Accept: application/json), ви можете просто використовувати Static Headers.

2. Чи бачить кінцевий користувач ці заголовки?
Ні. Кінцевий користувач бачить лише ті поля, які ви налаштували в блоці авторизації (Label). Назви заголовків у Static Headers — це суто технічна частина, прихована від користувача.

3. Де мені шукати змінні з блоку Custom, щоб вставити їх у Value?
Усі дані, які вводить користувач при підключенні акаунту, знаходяться в дереві змінних: Globals -> ACCOUNT.

4. Чи можна додати умовні заголовки?
Так. Для цього використовуйте режим EXP у полі Value та задавайте логіку через вирази (Expression). Це дозволяє, наприклад, додавати різні значення залежно від акаунту або середовища.