HTTP-запрос

Узел HTTP-запроса подключает ваш рабочий процесс к внешним API и веб-сервисам. Используйте его, чтобы получать данные, отправлять вебхуки, загружать файлы или интегрироваться с любым сервисом, который принимает HTTP-запросы.

​

Методы HTTP

Узел поддерживает все стандартные методы HTTP для разных типов операций:

​

Конфигурация

Настройте каждый аспект HTTP-запроса, включая URL, заголовки, параметры запроса, тело запроса и аутентификацию. Переменные из предыдущих узлов рабочего процесса можно динамически вставлять в любое место конфигурации запроса.

​

Подстановка переменных

Ссылайтесь на переменные рабочего процесса с помощью двойных фигурных скобок: {{variable_name}}. Интеллос поддерживает глубокий доступ к объектам, поэтому из предыдущих HTTP-ответов можно извлекать вложенные значения вроде {{api_response.data.items[0].id}}.

​

Настройка тайм-аутов

У HTTP-запросов есть настраиваемые тайм-ауты, которые предотвращают зависание:

• Тайм-аут соединения: максимальное время на установку соединения (значение по умолчанию зависит от развёртывания)
• Тайм-аут чтения: максимальное время на чтение данных ответа
• Тайм-аут записи: максимальное время на отправку данных запроса

Тайм-ауты применяются принудительно, чтобы поддерживать производительность рабочего процесса и предотвращать исчерпание ресурсов.

​

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

Узел поддерживает несколько типов аутентификации: Без аутентификации (type: "no-auth") — заголовки аутентификации не добавляются API-ключ (type: "api-key") с тремя подтипами:

• Базовая (type: "basic") — добавляет заголовок Basic Auth с кодированием base64
• Bearer (type: "bearer") — добавляет заголовок Authorization: Bearer <token>
• Пользовательская (type: "custom") — добавляет пользовательский заголовок с указанными именем и значением

​

Тело запроса

Выберите подходящий тип тела в зависимости от требований вашего API:

• JSON для структурированных данных
• Данные формы для традиционных веб-форм
• Двоичные данные для загрузки файлов
• Необработанный текст для пользовательских типов контента

​

Определение файлов

Узел HTTP-запроса автоматически определяет файловые ответы по продуманной логике:

1. Анализ Content-Disposition — проверяет наличие disposition attachment или параметров имени файла
2. Оценка MIME-типа — анализирует типы контента, чтобы отличить текст от двоичных данных
3. Выборка контента — для неоднозначных типов берёт первые 1024 байта и проверяет их на текстовые шаблоны

Текстовые ответы (JSON, XML, HTML и т. п.) обрабатываются как обычные данные, а двоичный контент становится файловыми переменными.

​

Операции с файлами

Узел HTTP-запроса без проблем выполняет загрузку и скачивание файлов: Загрузка файлов использует двоичное тело запроса. Выберите файловые переменные из предыдущих узлов, чтобы отправить файлы во внешние сервисы для хранения документов, обработки медиа или резервного копирования. Скачивание файлов обрабатывается автоматически, когда ответы содержат файловый контент. Скачанные файлы становятся доступны как файловые переменные для использования в нижестоящих узлах.

​

Обработка ошибок и повторные попытки

Настройте надёжную обработку ошибок для производственных рабочих процессов, которые зависят от внешних сервисов: Настройки повторных попыток автоматически повторяют неудавшиеся запросы до 10 раз с настраиваемыми интервалами (максимум 5000 мс). Это помогает справляться с временными сетевыми сбоями или недоступностью сервиса. Обработка ошибок задаёт альтернативные пути рабочего процесса при сбое HTTP-запросов, благодаря чему рабочий процесс продолжает выполняться, даже когда внешние API недоступны.

​

Обработка ответа

HTTP-ответы становятся структурированными переменными в последующих узлах с раздельным доступом к:

• Тело ответа — основной контент, возвращаемый API
• Код состояния — статус HTTP для условной логики
• Заголовки — метаданные ответа в виде пар «ключ-значение»
• Файлы — любой файловый контент, возвращаемый API
• Информация о размере — размер контента в байтах с читаемым форматированием (KB/MB)

​

Проверка SSL

Проверка SSL-сертификата настраивается для каждого узла (параметр ssl_verify). Это позволяет подключаться к внутренним сервисам с самоподписанными сертификатами, сохраняя безопасность при работе с внешними API.