http
— HTTP-модули¶
Исходный код: Lib/http/__init__.py
http
- это пакет, который собирает в себе несколько модулей для работы с протоколом передачи гипертекста:
http.client
- это низкоуровневый клиент протокола HTTP; для открытия URL-адреса высокого уровня используйтеurllib.request
http.server
содержит базовые классы HTTP-серверов, основанные наsocketserver
http.cookies
содержит утилиты для реализации управления состоянием с помощью файлов cookiehttp.cookiejar
обеспечивает сохранение файлов cookie
Модуль http
также определяет следующие перечисления, которые помогают вам работать с кодом, связанным с http:
- class http.HTTPStatus¶
Добавлено в версии 3.5.
Подкласс
enum.IntEnum
, который определяет набор кодов состояния HTTP, фраз-причин и длинных описаний, написанных на английском языке.Использование:
>>> from http import HTTPStatus >>> HTTPStatus.OK HTTPStatus.OK >>> HTTPStatus.OK == 200 True >>> HTTPStatus.OK.value 200 >>> HTTPStatus.OK.phrase 'OK' >>> HTTPStatus.OK.description 'Request fulfilled, document follows' >>> list(HTTPStatus) [HTTPStatus.CONTINUE, HTTPStatus.SWITCHING_PROTOCOLS, ...]
Коды состояния HTTP¶
Поддерживаемые, IANA-registered status codes доступные в http.HTTPStatus
являются:
Код |
Имя перечисления |
Подробности |
---|---|---|
|
|
HTTP/1.1 RFC 7231, Раздел 6.2.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.2.2 |
|
|
WebDAV RFC 2518, раздел 10.1 |
|
|
Код состояния HTTP для указания подсказок RFC 8297 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.3.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.3.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.3.3 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.3.4 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.3.5 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.3.6 |
|
|
HTTP/1.1 RFC 7233, Раздел 4.1 |
|
|
WebDAV RFC 4918, Раздел 11.1 |
|
|
Расширения привязки WebDAV RFC 5842, раздел 7.1 (экспериментальный) |
|
|
Дельта-кодирование в HTTP RFC 3229, раздел 10.4.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.4.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.4.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.4.3 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.4.4 |
|
|
HTTP/1.1 RFC 7232, Раздел 4.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.4.5 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.4.7 |
|
|
Постоянный редирект RFC 7238, раздел 3 (экспериментальный) |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.1 |
|
|
Аутентификация по протоколу HTTP/1.1 RFC 7235, раздел 3.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.3 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.4 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.5 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.6 |
|
|
Аутентификация по протоколу HTTP/1.1 RFC 7235, раздел 3.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.7 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.8 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.9 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.10 |
|
|
HTTP/1.1 RFC 7232, Раздел 4.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.11 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.12 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.13 |
|
|
HTTP/1.1 Запросы диапазона RFC 7233, раздел 4.4 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.14 |
|
|
HTCPCP/1.0 RFC 2324, Раздел 2.3.2 |
|
|
HTTP/2 RFC 7540, Раздел 9.1.2 |
|
|
WebDAV RFC 4918, раздел 11.2 |
|
|
WebDAV RFC 4918, раздел 11.3 |
|
|
WebDAV RFC 4918, раздел 11.4 |
|
|
Использование ранних данных в HTTP RFC 8470 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.5.15 |
|
|
Дополнительные коды состояния HTTP RFC 6585 |
|
|
Дополнительные коды состояния HTTP RFC 6585 |
|
|
Дополнительные коды состояния HTTP RFC 6585 |
|
|
Код состояния HTTP для сообщения о юридических препятствиях RFC 7725 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.6.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.6.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.6.3 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.6.4 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.6.5 |
|
|
HTTP/1.1 RFC 7231, Раздел 6.6.6 |
|
|
Прозрачное согласование содержимого в протоколе HTTP RFC 2295, раздел 8.1 (Экспериментальный) |
|
|
WebDAV RFC 4918, раздел 11.5 |
|
|
Расширения привязки WebDAV RFC 5842, раздел 7.2 (экспериментальный) |
|
|
Платформа расширения HTTP RFC 2774, раздел 7 (экспериментальный) |
|
|
Дополнительные коды состояния HTTP RFC 6585, раздел 6 |
Чтобы сохранить обратную совместимость, перечислимые значения также присутствуют в модуле http.client
в виде констант. Имя перечисления равно имени константы (т.е. http.HTTPStatus.OK
также доступно как http.client.OK
).
Изменено в версии 3.7: Добавлен код состояния 421 MISDIRECTED_REQUEST
.
Добавлено в версии 3.8: Добавлен код состояния 451 UNAVAILABLE_FOR_LEGAL_REASONS
.
Добавлено в версии 3.9: Добавлены коды состояния 103 EARLY_HINTS
, 418 IM_A_TEAPOT
и 425 TOO_EARLY
.
- class http.HTTPMethod¶
Добавлено в версии 3.11.
Подкласс
enum.StrEnum
, который определяет набор HTTP-методов и описаний, написанных на английском языке.Использование:
>>> from http import HTTPMethod >>> >>> HTTPMethod.GET <HTTPMethod.GET> >>> HTTPMethod.GET == 'GET' True >>> HTTPMethod.GET.value 'GET' >>> HTTPMethod.GET.description 'Retrieve the target.' >>> list(HTTPMethod) [<HTTPMethod.CONNECT>, <HTTPMethod.DELETE>, <HTTPMethod.GET>, <HTTPMethod.HEAD>, <HTTPMethod.OPTIONS>, <HTTPMethod.PATCH>, <HTTPMethod.POST>, <HTTPMethod.PUT>, <HTTPMethod.TRACE>]
HTTP-методы¶
Поддерживаемые, IANA-registered methods доступные в http.HTTPMethod
являются:
Метод |
Имя перечисления |
Подробности |
---|---|---|
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.1 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.2 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.3 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.4 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.5 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.6 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.7 |
|
|
HTTP/1.1 RFC 7231, Раздел 4.3.8 |
|
|
HTTP/1.1 RFC 5789 |