КлиентHttp

Иерархия типа

graph BT;
КлиентHttp-->Объект;

Объект для работы с внешними ресурсами по протоколу HTTP.

Сравнение ссылочное

Примеры

Использование абсолютных и относительных Url в запросах:

исп Ответ = КлиентHttp.СБазовымUrl("http://адрес")
                .ЗапросGet("/путь/к/ресурсу")
                .Выполнить()

// или
исп Ответ = КлиентHttp.ЗапросGet("http://адрес/путь/к/ресурсу").Выполнить()

// или
знч Ссылка = новый Url("http://адрес").СПутем("/путь/к/ресурсу")
исп Ответ = КлиентHttp.ЗапросGet(Ссылка).Выполнить()

Использование аутентификации и таймаута запроса:

знч Аутентификация = новый АутентификацияHttp("пользователь", "пароль")
исп Ответ = КлиентHttp.САутентификацией(Аутентификация)
                .СТаймаутомЗапроса(15с)
                .ЗапросGet("http://адрес")
                .Выполнить()

Свойства

Аутентификация

Данные аутентификации.

БазовыйUrl

Базовый URL-адрес.

МаксимумПеренаправлений

Максимальное количество перенаправлений.

Прокси

Настройки прокси-сервера.

ТаймаутЗапроса

Время ожидания выполнения запроса.

ТаймаутСоединения

Время ожидания установки соединения.

Методы

ЗапросConnect

ЗапросConnect(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом CONNECT и Url (абсолютным или относительным).

ЗапросDelete

ЗапросDelete(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом DELETE и Url (абсолютным или относительным).

ЗапросGet

ЗапросGet(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом GET и Url (абсолютным или относительным).

ЗапросHead

ЗапросHead(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом HEAD и Url (абсолютным или относительным).

ЗапросOptions

ЗапросOptions(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом OPTIONS и Url (абсолютным или относительным).

ЗапросPatch

ЗапросPatch(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом PATCH и Url (абсолютным или относительным).

ЗапросPost

ЗапросPost(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом POST и Url (абсолютным или относительным).

ЗапросPut

ЗапросPut(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом PUT и Url (абсолютным или относительным).

ЗапросTrace

ЗапросTrace(Url: Url|Строка): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом TRACE и Url (абсолютным или относительным).

САутентификацией

САутентификацией(Аутентификация: АутентификацияHttp?): КлиентHttp

Возвращает копию объекта с заданной аутентификацией Аутентификация. Если передано значение Undefined, то аутентификация не используется.

СБазовымUrl

СБазовымUrl(Url: Url|Строка): КлиентHttp

Возвращает копию объекта с базовым URL-адресом Url, который будет использован для всех запросов, у которых не указан абсолютный путь.

СКриптоПроTls

СКриптоПроTls(ИспользоватьКриптоПроTls: Булево = Истина): КлиентHttp

Возвращает копию объекта с настройкой работы по протоколу TLS с шифрованием ГОСТ на основе КриптоПро ИспользоватьКриптоПроTls.

Исключения

ИсключениеКриптографии - если провайдер КриптоПро не зарегистрирован в системе.

Примеры

знч ДоверенныеСертификаты = новый ХранилищеPkcs12()
ДоверенныеСертификаты.ДобавитьСертификат("мой сертификат", СертификатГост)
 
знч Ответ = КлиентHttp.СКриптоПроTls()
                .СПараметрамиЗащиты(новый ПараметрыЗащищенногоСоединения(ДоверенныеСертификаты))          
                .СТаймаутомЗапроса(15с)
                .ЗапросGet("https://адрес")
                .Выполнить()

СМаксимумомПеренаправлений

СМаксимумомПеренаправлений(Количество: Число): КлиентHttp

Возвращает копию объекта с указанным максимумом перенаправлений Количество.

СПараметрамиЗащиты

СПараметрамиЗащиты(Параметры: ПараметрыЗащищенногоСоединения): КлиентHttp

Возвращает копию объекта с указанными параметрами защищенного соединения Параметры.

СПрокси

СПрокси(Прокси: ИнтернетПрокси?): КлиентHttp

Возвращает копию объекта с переданными настройками прокси-сервера Прокси. Если передано значение Undefined, то прокси-сервер не используется

СТаймаутомЗапроса

СТаймаутомЗапроса(Таймаут: Длительность): КлиентHttp

Возвращает копию объекта с указанным временем ожидания запроса Таймаут.

СТаймаутомСоединения

СТаймаутомСоединения(Таймаут: Длительность): КлиентHttp

Возвращает копию объекта с временем ожидания установки соединения Таймаут.

СоздатьЗапрос

СоздатьЗапрос(
  Метод: Строка,
  Url: Url|Строка
): ЗапросHttp

Возвращает ЗапросHttp с HTTP-методом Метод и Url (абсолютным или относительным).

Список унаследованных методов

Объект