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

Клиент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 (абсолютным или относительным).


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

Объект​

ВСтроку

ПолучитьТип

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