Модуль 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", используя переменную подключения;

Ответ

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

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

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

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

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

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

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

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