Перейти к основному содержимому

КлиентHttp

Стд::Http::КлиентHttp

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

Сравнение

Ссылочное

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

Базовые типы: Объект

Примеры​

Общие примеры

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

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

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

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

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

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

Свойства​

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

ТолькоЧтение

Аутентификация: АутентификацияHttp?

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

БазовыйUrl​

ТолькоЧтение

Базовый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
Возвращает копию объекта с заданной аутентификацией Аутентификация. Если передано значение Неопределено, то аутентификация не используется.

СБазовымUrl​

СБазовымUrl(Url: Url|Строка): КлиентHttp
Возвращает копию объекта с базовым URL-адресом Url, который будет использован для всех запросов, у которых не указан абсолютный путь.

СКриптоПроTls​

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

Исключения​

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

Примеры​

знч ДоверенныеСертификаты = новый ХранилищеPkcs12()
ДоверенныеСертификаты.ДобавитьСертификат("мой сертификат", новый ЦифровойСертификат(""))

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

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

СМаксимумомПеренаправлений(Количество: Число): КлиентHttp
Возвращает копию объекта с указанным максимумом перенаправлений Количество.

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

СПараметрамиЗащиты(Параметры: ПараметрыЗащищенногоСоединения): КлиентHttp
Возвращает копию объекта с указанными параметрами защищенного соединения Параметры.

СПрокси​

СПрокси(Прокси: ИнтернетПрокси?): КлиентHttp
Возвращает копию объекта с переданными настройками прокси-сервера Прокси. Если передано значение Неопределено, то прокси-сервер не используется

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

СТаймаутомЗапроса(Таймаут: Длительность): КлиентHttp
Возвращает копию объекта с указанным временем ожидания запроса Таймаут.

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

СТаймаутомСоединения(Таймаут: Длительность): КлиентHttp
Возвращает копию объекта с временем ожидания установки соединения Таймаут.

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

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

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

Объект​

ВСтроку

ПолучитьТип

Представление

Последнее обновление