http — HTTP modules

Вихідний код: Lib/http/__init__.py


http — пакет, який збирає кілька модулів для роботи з протоколом передачі гіпертексту:

  • http.client є низькорівневим клієнтом протоколу HTTP; для відкриття URL високого рівня використовуйте urllib.request

  • http.server містить основні класи HTTP-серверів на основі socketserver

  • http.cookies має утиліти для здійснення управління станом за допомогою файлів cookie

  • http.cookiejar забезпечує збереження файлів cookie

http is also a module that defines a number of HTTP status codes and associated messages through the http.HTTPStatus enum:

class http.HTTPStatus

Нове в версії 3.5.

Підклас enum.IntEnum, який визначає набір кодів стану HTTP, фраз причин і довгих описів, написаних англійською мовою.

Використання:

>>> from http import HTTPStatus
>>> HTTPStatus.OK
<HTTPStatus.OK: 200>
>>> HTTPStatus.OK == 200
True
>>> HTTPStatus.OK.value
200
>>> HTTPStatus.OK.phrase
'OK'
>>> HTTPStatus.OK.description
'Request fulfilled, document follows'
>>> list(HTTPStatus)
[<HTTPStatus.CONTINUE: 100>, <HTTPStatus.SWITCHING_PROTOCOLS: 101>, ...]

Коди стану HTTP

Supported, IANA-registered status codes available in http.HTTPStatus are:

Код

Назва переліку

Подробиці

100

`` ПРОДОВЖИТИ``

HTTP/1.1 RFC 7231, Section 6.2.1

101

SWITCHING_PROTOCOLS

HTTP/1.1 RFC 7231, Section 6.2.2

102

ОБРОБКА

WebDAV RFC 2518, Розділ 10.1

103

EARLY_HINTS

Код статусу HTTP для вказівки підказок RFC 8297

200

ОК

HTTP/1.1 RFC 7231, Section 6.3.1

201

СТВОРЕНО

HTTP/1.1 RFC 7231, Section 6.3.2

202

`` ПРИЙНЯТО``

HTTP/1.1 RFC 7231, Section 6.3.3

203

НЕ_АВТОРИТАТИВНА_ІНФОРМАЦІЯ

HTTP/1.1 RFC 7231, Section 6.3.4

204

БЕЗ_ВМІСТУ

HTTP/1.1 RFC 7231, Section 6.3.5

205

RESET_CONTENT

HTTP/1.1 RFC 7231, Section 6.3.6

206

PARTIAL_CONTENT

HTTP/1.1 RFC 7233, Section 4.1

207

МУЛЬТИ_СТАТУС

WebDAV RFC 4918, Розділ 11.1

208

ВЖЕ_ПОВІДОМЛЕНО

Розширення зв’язування WebDAV RFC 5842, розділ 7.1 (експериментальний)

226

IM_USED

Дельта-кодування в HTTP RFC 3229, Розділ 10.4.1

300

MULTIPLE_CHOICES

HTTP/1.1 RFC 7231, Section 6.4.1

301

ПЕРЕМІЩЕНО_ПОСТІЙНО

HTTP/1.1 RFC 7231, Section 6.4.2

302

ЗНАЙДЕНО

HTTP/1.1 RFC 7231, Section 6.4.3

303

SEE_OTHER

HTTP/1.1 RFC 7231, Section 6.4.4

304

NOT_MODIFIED

HTTP/1.1 RFC 7232, Section 4.1

305

USE_PROXY

HTTP/1.1 RFC 7231, Section 6.4.5

307

TEMPORARY_REDIRECT

HTTP/1.1 RFC 7231, Section 6.4.7

308

ПОСТІЙНЕ_ПЕРЕСПРАВЛЕННЯ

Permanent Redirect RFC 7238, Section 3 (Experimental)

400

BAD_REQUEST

HTTP/1.1 RFC 7231, Section 6.5.1

401

НЕАВТОРИЗОВАНО

HTTP/1.1 Authentication RFC 7235, Section 3.1

402

PAYMENT_REQUIRED

HTTP/1.1 RFC 7231, Section 6.5.2

403

ЗАБОРОНЕНО

HTTP/1.1 RFC 7231, Section 6.5.3

404

НЕ_ЗНАЙДЕНО

HTTP/1.1 RFC 7231, Section 6.5.4

405

METHOD_NOT_ALLOWED

HTTP/1.1 RFC 7231, Section 6.5.5

406

NOT_ACCEPTABLE

HTTP/1.1 RFC 7231, Section 6.5.6

407

PROXY_AUTHENTICATION_REQUIRED

HTTP/1.1 Authentication RFC 7235, Section 3.2

408

REQUEST_TIMEOUT

HTTP/1.1 RFC 7231, Section 6.5.7

409

КОНФЛІКТ

HTTP/1.1 RFC 7231, Section 6.5.8

410

ПІШЕЛ

HTTP/1.1 RFC 7231, Section 6.5.9

411

LENGTH_REQUIRED

HTTP/1.1 RFC 7231, Section 6.5.10

412

PRECONDITION_FAILED

HTTP/1.1 RFC 7232, Section 4.2

413

REQUEST_ENTITY_TOO_LARGE

HTTP/1.1 RFC 7231, Section 6.5.11

414

REQUEST_URI_TOO_LONG

HTTP/1.1 RFC 7231, Section 6.5.12

415

UNSUPPORTED_MEDIA_TYPE

HTTP/1.1 RFC 7231, Section 6.5.13

416

REQUESTED_RANGE_NOT_SATISFIABLE

HTTP/1.1 Range Requests RFC 7233, Section 4.4

417

EXPECTATION_FAILED

HTTP/1.1 RFC 7231, Section 6.5.14

418

Я_ЧАЙНИК

HTTPS/1.0 RFC 2324, Розділ 2.3.2

421

MISDIRECTED_REQUEST

HTTP/2 RFC 7540, Section 9.1.2

422

UNPROCESSABLE_ENTITY

WebDAV RFC 4918, Section 11.2

423

ЗАБЛОКУВАНО

WebDAV RFC 4918, Розділ 11.3

424

FAILED_DEPENDENCY

WebDAV RFC 4918, Розділ 11.4

425

НАДАНТО_РАНО

Використання ранніх даних у HTTP RFC 8470

426

UPGRADE_REQUIRED

HTTP/1.1 RFC 7231, Section 6.5.15

428

PRECONDITION_REQUIRED

Додаткові коди стану HTTP RFC 6585

429

TOO_MANY_REQUESTS

Додаткові коди стану HTTP RFC 6585

431

REQUEST_HEADER_FIELDS_TOO_LARGE

Додаткові коди стану HTTP RFC 6585

451

НЕДОСТУПНИЙ_З_ЮРИДИЧНИХ_ПРИЧИН

Код статусу HTTP для повідомлення про юридичні перешкоди RFC 7725

500

INTERNAL_SERVER_ERROR

HTTP/1.1 RFC 7231, Section 6.6.1

501

NOT_IMPLEMENTED

HTTP/1.1 RFC 7231, Section 6.6.2

502

BAD_GATEWAY

HTTP/1.1 RFC 7231, Section 6.6.3

503

СЛУЖБА_НЕДОСТУПНА

HTTP/1.1 RFC 7231, Section 6.6.4

504

GATEWAY_TIMEOUT

HTTP/1.1 RFC 7231, Section 6.6.5

505

HTTP_VERSION_NOT_SUPPORTED

HTTP/1.1 RFC 7231, Section 6.6.6

506

VARIANT_ALSO_NEGOTIATES

Узгодження прозорого вмісту в HTTP RFC 2295, розділ 8.1 (експериментальний)

507

INSUFFICIENT_STORAGE

WebDAV RFC 4918, Розділ 11.5

508

LOOP_DETECTED

Розширення прив’язки WebDAV RFC 5842, розділ 7.2 (експериментальний)

510

NOT_EXTENDED

Фреймворк розширення HTTP RFC 2774, Розділ 7 (Експериментальний)

511

NETWORK_AUTHENTICATION_REQUIRED

Додаткові коди стану HTTP RFC 6585, Розділ 6

Щоб зберегти зворотну сумісність, значення enum також присутні в модулі 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.