http.client – клиент протокола HTTP¶http.client – HTTP protocol client

Этот модуль определяет классы, реализующие клиентскую сторону протоколов HTTP и HTTPS. Обычно он не используется напрямую – модуль urllib.request применяет его для обработки URL, использующих HTTP и HTTPS.

Модуль предоставляет следующие классы:

class http.client.HTTPConnection(host[, port[, strict[, timeout]]])¶

Экземпляр HTTPConnection представляет одну транзакцию с HTTP-сервером. Его следует создавать, передавая хост и необязательный номер порта. Если номер порта не передан, порт извлекается из строки хоста, если она имеет вид host:port; в противном случае используется порт HTTP по умолчанию (80). Если True, необязательный параметр strict (по умолчанию ложное значение) вызывает BadStatusLine, если строка состояния не может быть разобрана как допустимая строка состояния HTTP/1.0 или 1.1. Если задан необязательный параметр timeout, блокирующие операции (например, попытки соединения) будут прерваны по истечении этого количества секунд (если он не задан, используется глобальная настройка таймаута по умолчанию).

Например, следующие вызовы создают экземпляры, подключающиеся к одному и тому же серверу по одному и тому же хосту и порту:

>>> h1 = http.client.HTTPConnection('www.cwi.nl')
>>> h2 = http.client.HTTPConnection('www.cwi.nl:80')
>>> h3 = http.client.HTTPConnection('www.cwi.nl', 80)
>>> h3 = http.client.HTTPConnection('www.cwi.nl', 80, timeout=10)

class http.client.HTTPSConnection(host[, port[, key_file[, cert_file[, strict[, timeout]]]]])¶

Подкласс HTTPConnection, использующий SSL для связи с защищёнными серверами. Порт по умолчанию: 443. key_file – это имя PEM-файла, содержащего ваш закрытый ключ. cert_file – это PEM-файл цепочки сертификатов.

Предупреждение

Проверка сертификатов не выполняется!

class http.client.HTTPResponse(sock[, debuglevel=0][, strict=0])¶

Класс, экземпляры которого возвращаются при успешном подключении. Не создаётся напрямую пользователем.

При необходимости генерируются следующие исключения:

exception http.client.HTTPException¶

Базовый класс остальных исключений этого модуля. Является подклассом Exception.

exception http.client.NotConnected¶

Подкласс HTTPException.

exception http.client.InvalidURL¶

Подкласс HTTPException; возбуждается, если указан порт, но он не является числом или пуст.

exception http.client.UnknownProtocol¶

Подкласс HTTPException.

exception http.client.UnknownTransferEncoding¶

Подкласс HTTPException.

exception http.client.UnimplementedFileMode¶

Подкласс HTTPException.

exception http.client.IncompleteRead¶

Подкласс HTTPException.

exception http.client.ImproperConnectionState¶

Подкласс HTTPException.

exception http.client.CannotSendRequest¶

Подкласс ImproperConnectionState.

exception http.client.CannotSendHeader¶

Подкласс ImproperConnectionState.

exception http.client.ResponseNotReady¶

Подкласс ImproperConnectionState.

exception http.client.BadStatusLine¶

Подкласс HTTPException. Возникает, если сервер отвечает кодом состояния HTTP, который не удаётся распознать.

Константы, определённые в этом модуле:

http.client.HTTP_PORT¶

Порт по умолчанию для протокола HTTP (всегда 80).

http.client.HTTPS_PORT¶

Порт по умолчанию для протокола HTTPS (всегда 443).

а также следующие константы для целочисленных кодов состояния:

http.client.responses¶

Этот словарь сопоставляет коды состояния HTTP 1.1 с названиями W3C.

Пример: http.client.responses[http.client.NOT_FOUND] – это 'Not Found'.

>>> import http.client
>>> conn = http.client.HTTPConnection("www.python.org")
>>> conn.request("GET", "/index.html")
>>> r1 = conn.getresponse()
>>> print(r1.status, r1.reason)
200 OK
>>> data1 = r1.read()
>>> conn.request("GET", "/parrot.spam")
>>> r2 = conn.getresponse()
>>> print(r2.status, r2.reason)
404 Not Found
>>> data2 = r2.read()
>>> conn.close()

>>> import http.client, urllib.parse
>>> params = urllib.parse.urlencode({'spam': 1, 'eggs': 2, 'bacon': 0})
>>> headers = {"Content-type": "application/x-www-form-urlencoded",
...            "Accept": "text/plain"}
>>> conn = http.client.HTTPConnection("musi-cal.mojam.com:80")
>>> conn.request("POST", "/cgi-bin/query", params, headers)
>>> response = conn.getresponse()
>>> print(response.status, response.reason)
200 OK
>>> data = response.read()
>>> conn.close()