Модуль HTTP

• Главная
• Возможности
• Модули
• HTTP

HTTP модуль служит для отправки запроса с данными из APInita в необходимый веб-сервис:

Название шага - произвольное название, например "Передаем данные" или "Отправляем заявку";

Запрос

URL-запроса - ссылка на метод сервиса, куда будут передаваться данные. Значение поля можно указать как "-", чтобы использовать модуль в качестве триггера запуска сценария по таймеру и не выполнять запрос;

Метод - метод передачи данных в сервис: POST, GET, PUT, MERGE, PATH, DELETE;

Формат данных - один из трех вариантов:

• application/json - JSON формат, заголовок Content-Type передается в header ({"result": {"status": "ok"}, "message": "Thank you!"});
• application/x-www-form-urlencoded - формат кодированной строки, заголовок Content-Type передается в header ("result[status]=ok&message=Thank%20you!");
• text/plain - произвольный формат, заголовок Content-Type передается в header. Переопределить заголовок можно указав ключ "Content-Type" и значение в поле "Заголовки запроса"

Поля запроса - для типа данных application/json и application/x-www-form-urlencoded вводятся пары ключ-значение (ключ "order_id", значение "1"), для text/plain используется любой другой формат, при этом может потребоваться изменить заголовок (указать ключ "Content-Type" и значение в поле "Заголовки запроса");

Заголовоки запроса - указываются в парах ключ-значение (ключ "Content-Type", значение "application/json");

Подключение - если к запросу требуется подключение, его можно выбрать из списка (подключение должно быть предварительно создано). При использовании типа подключения "Custom", типе данных "text/plain" и передаче полей из тела подключенния - переменные нужно (при необходимости) прописать вручную в блоке запроса "text/plain", используя переменную подключения;

В случае, если сервер не отвечает в течение 10 секунд или отвечает кодом 5xx, модуль делает дополнительно 3 попытки повторной отправки запроса с интервалом 10 секунд.

Максимальное время выполнения всего сценария, включающего в том числе несколько HTTP-модулей - 90 секунд.

Ответ

Считать успешным - код/коды ответа, который будет считаться успешным, можно переопределить, по-умолчанию любой;

Формат данных - тип данных ответа, по-умолчанию определяется на основе Content-Type (Автоопределение), можно указать вручную;

Продолжить выполнение дочерних шагов, если модуль вернул ошибку - если опция включена, сценарий продолжит работу в случае, если код ответа не совпадает с заданным (может потребоваться, например, для отслеживания ошибок и/или отправки уведомлений через модуль IF).

В полях "URL-запроса", "Поля запроса", "Заголовки запроса" доступно использование переменных.

HTTP модуль, установленный в качестве первого шага, так же имеет возможность настройки расписания для запуска:

Произвести настройку запуска сценария можно с точностью до минуты.

Другие модули

• Webhook - входящий запрос;
• Response - ответ на входящий запрос;
• Iterator - цикл для работы с массиом (набором) данных;
• IF - создание условий;
• JS - написание собственной логики обработки данных на языке JavaScript;
• Mail - отправка почты с Email адреса;
• DB - база данных для операций записи, чтения, обновления и удаления строк;