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

Функціональний блок HTTP_REQUEST створює сирове запитання для інтерфейсу HTTP.

Важливо: Змінна, яку потрібно відправити через інтерфейс HTTP, повинна мати тип даних RAW.

URI визначається як змінна справа під комунікацією. Якщо вона починається з /, то перший символ / видаляється. Якщо потрібно зробити запит до найнижчого каталогу, можна визначити лише змінну /.

Деякі вебсервери вимагають заголовка User-Agent. В іншому випадку сторінка не завантажується. Це не помилка Antcas Control, а механізм захисту запитуваного веббраузера. Використовуйте вхідний заголовок з наступним вмістом:

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

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

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

Вхід Timeout

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

Вхід DIS

Якщо вхід істинний, то значення на виході Request буде рівне NULL.

Вхід SET

Якщо вхід істинний, то він примусово генерує вихід Request. Цей вхід має пріоритет над входом DIS.

Вихід Request

Вихід повертає рядок у форматі JSON. Якщо він деактивований, то повертається значення NULL. Зазвичай його безпосередньо з'єднують із вихідною змінною інтерфейсу.

Вихід Length

Вихід повертає довжину входу Content у байтах.

Вихід ID

Повертає ID останнього створеного запиту. Це корисно для перевірки відповіді за допомогою функціонального блоку HTTP_RESPONSE.