Функциональный блок HTTP_REQUEST

Функциональный блок HTTP_REQUEST создает RAW-запрос для интерфейса HTTP.

Важно: Передаваемая переменная от интерфейса HTTP должна иметь тип данных RAW.

URI определяется как переменная справа в разделе Коммуникация. Если URI начинается с /, то первое / удаляется. Для запроса на самый нижний каталог можно определить только переменную /.

Некоторые веб-серверы требуют заголовок User-Agent. В противном случае страница не загружается. Это не ошибка Antcas Control, а механизм защиты запрашиваемого веб-браузера. Используйте вход Header со следующим содержимым:

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

Вход Method

Вход определяет метод передачи как строку символов. Это может быть, например, "GET", "POST", "PUT" и т.д. Если метод не определен, то по умолчанию выбирается GET.

Вход Type

Вход определяет заголовок Content-Type как строку символов. Если вход не определен, то запись не добавляется в заголовок.

Вход Header

Определяет дополнительные записи заголовков как строку символов. Несколько заголовков разделяются переносом строки. Заголовок Content-Length определяется автоматически, а заголовок Content-Type определяется значением входа Type.

Вход Query

Вход определяет запрос как строку символов. Запрос — это значение после вопросительного знака и обычно используется при GET-запросах.

http://server/uri?query

Структура запроса выглядит следующим образом:

var1=wert1&var2=wert2&va...

Чтобы значения могли быть корректно переданы, рекомендуется кодировать отдельные значения с помощью функционального блока URL_ENCODE или QUERY_ENCODE, так как данные могут быть переданы не полностью.

Примечание: Учитывайте максимальную длину URL, если необходимо передавать большие объемы данных. В этом случае используйте метод POST и отправляйте запрос в качестве содержимого.

Вход Content

Вход Content похож на вход Query. Однако данные передаются после заголовка, и поддерживаются большие объемы данных. В зависимости от применения тип Content может не иметь метода запроса.

Примечание: Поддерживаются только данные в кодировке UTF-8. При передаче двоичных данных рекомендуется кодировать их с помощью функционального блока BASE64_ENCODE.

Вход Timeout

Вход определяет тайм-аут запроса как время в формате T#30s в секундах. Рекомендуется использовать высокий тайм-аут. Малые значения могут привести к тому, что запросы не будут выполнены полностью. Из-за процесса Keep-Alive может потребоваться некоторое время, прежде чем запросы снова будут обрабатываться нормально.

Вход DIS

Если вход истинен, то значение на выходе Request равно NULL.

Вход SET

Если вход истинен, то он принудительно генерирует выход Request. Этот вход имеет приоритет перед входом DIS.

Выход Request

Выход возвращает строку символов в формате JSON. Если он был деактивирован, возвращается значение NULL. Обычно он напрямую соединяется с выходной переменной интерфейса.

Выход Length

Выход возвращает длину входа Content в байтах.

Выход ID

Возвращает ID последнего созданного запроса. Это полезно для проверки ответа с помощью функционального блока HTTP_RESPONSE.