База знаний

Справочная система SP-XML

Связанные темы:

Функции для работы с объектами
Преобразование типов данных
Преобразование форматов и кодировок
Работа со строками
Работа с датами
Работа с массивами
Работа с файловой системой
Работа с URL
Обработка HTML
Работа с формами данных
Работа с базой данных приложения
Работа с документами XML
Работа с элементами XML
Работа с экранами
Работа с реестром Windows
Выполнение кода
Функции Web-сервера
Управление сервером приложения
Системные функции
Прочие функции
Эксперементальные и узкоспециализированные функции
Устаревшие функции

HttpRequest()

Выполняет HTTP-запрос.

Возвращает объект HttpResponse

 

Пример:


 

Среди списка дополнительных полей заголовка возможно использование следующих опций, которые обрабатываются отдельно и не попадают в передаваемый заголовок:

Ignore-Errors - Игнорировать наличие кода ошибки HTTP в ответе. Если указана эта опция, код ошибки можно получить через атрибут RespCode возвращаемого объекта. По умолчанию функция завершается с ошибкой в случае получения кода ошибки по HTTP.

Auto-Redirect - Автоматически следовать редиректам HTTP 303, HTTP 304. По умолчанию true.

Синтаксис

HttpRequest( url )

HttpRequest( url, method )

HttpRequest( url, method, body )

HttpRequest( url, method, body, options )

Аргументы

urlstring

Запрашиваемый URL

methodstringoptional

Метод ('get', 'post', и др.) По умолчанию 'get'.

bodystringoptional

Тело запроса в виде строки либо объекта Binary. Если передано значение undefined, то для совместимости с устаревшей нотацией следующий параметр options должен быть обаятельно указан.

optionsstringoptional

Список опций и дополнительных полей заголовка http-запроса в формате INI (имя:значение перевод строки). Известные поля интерпретируются как опции (см. описание ниже). Остальные добавляются как заголовки запроса.

Описание

Среди списка дополнительных полей заголовка возможно использование следующих опций, которые обрабатываются отдельно и не попадают в передаваемый заголовок:

Content-Type - поле

Ignore-Errors - Игнорировать наличие кода ошибки HTTP в ответе. Если указана эта опция, код ошибки можно получить через атрибут RespCode возвращаемого объекта. По умолчанию функция завершается с ошибкой в случае получения кода ошибки по HTTP.

Auto-Redirect - Автоматически следовать редиректам HTTP 303, HTTP 304. По умолчанию true.

Ask-Auth - Показывать окно авторизации при получении результата HTTP 401. По умолчанию true на клиентской части приложения.

AuthLogin - логин для авторизации.

AuthPassword - пароль для авторизации.

IgnoreStoredCookies - игнорировать сохраненные ранее куки.



Пример

HttpRequest( 'http://reg.datex-soft.com/' )
HttpRequest( 'http://reg.datex-soft.com/login.htm', 'post', UrlEncodeQuery( {login:'xxx',password:'xxx'} ) )
HttpRequest( 'http://reg.datex-soft.com/login.htm', 'post', '<xxx>111</xxx>', 'Content-type: text/xml\nIgnore-Errors: 1\nAskAuth: 0' )