http --- HTTP 模塊?

源代碼: Lib/http/__init__.py

http 是一個(gè)包，它收集了多個(gè)用于處理超文本傳輸協(xié)議的模塊:

  • http.client 是一個(gè)低層級(jí)的 HTTP 協(xié)議客戶端；對(duì)于高層級(jí)的 URL 訪問請(qǐng)使用 urllib.request

  • http.server 包含基于 socketserver 的基本 HTTP 服務(wù)類

  • http.cookies 包含一些有用來實(shí)現(xiàn)通過 cookies 進(jìn)行狀態(tài)管理的工具

  • http.cookiejar 提供了 cookies 的持久化

The http module also defines the following enums that help you work with http related code:

class http.HTTPStatus?

3.5 新版功能.

enum.IntEnum 的子類，它定義了組 HTTP 狀態(tài)碼，原理短語以及用英語書寫的長(zhǎng)描述文本。

用法：

>>>
>>> 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 狀態(tài)碼?

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

雙字母代碼

映射名

詳情

100

CONTINUE：繼續(xù)

HTTP/1.1 RFC 7231, 6.2.1 節(jié)

101

SWITCHING_PROTOCOLS

HTTP/1.1 RFC 7231, 6.2.2 節(jié)

102

PROCESSING

WebDAV RFC 2518, 10.1 節(jié)

103

EARLY_HINTS

用于指定提示 RFC 8297 的 HTTP 狀態(tài)碼

200

OK

HTTP/1.1 RFC 7231, 6.3.1 節(jié)

201

CREATED

HTTP/1.1 RFC 7231, 6.3.2 節(jié)

202

ACCEPTED

HTTP/1.1 RFC 7231, 6.3.3 節(jié)

203

NON_AUTHORITATIVE_INFORMATION

HTTP/1.1 RFC 7231, 6.3.4 節(jié)

204

NO_CONTENT: 沒有內(nèi)容

HTTP/1.1 RFC 7231, 6.3.5 節(jié)

205

RESET_CONTENT

HTTP/1.1 RFC 7231, 6.3.6 節(jié)

206

PARTIAL_CONTENT

HTTP/1.1 RFC 7233, 4.1 節(jié)

207

MULTI_STATUS

WebDAV RFC 4918, 11.1 節(jié)

208

ALREADY_REPORTED

WebDAV Binding Extensions RFC 5842, 7.1 節(jié)（實(shí)驗(yàn)性）

226

IM_USED

Delta Encoding in HTTP RFC 3229, 10.4.1 節(jié)

300

MULTIPLE_CHOICES：有多種資源可選擇

HTTP/1.1 RFC 7231, 6.4.1 節(jié)

301

MOVED_PERMANENTLY：永久移動(dòng)

HTTP/1.1 RFC 7231, 6.4.2 節(jié)

302

FOUND：臨時(shí)移動(dòng)

HTTP/1.1 RFC 7231, 6.4.3 節(jié)

303

SEE_OTHER：已經(jīng)移動(dòng)

HTTP/1.1 RFC 7231, 6.4.4 節(jié)

304

NOT_MODIFIED：沒有修改

HTTP/1.1 RFC 7232, 4.1 節(jié)

305

USE_PROXY：使用代理

HTTP/1.1 RFC 7231, 6.4.5 節(jié)

307

TEMPORARY_REDIRECT：臨時(shí)重定向

HTTP/1.1 RFC 7231, 6.4.7 節(jié)

308

PERMANENT_REDIRECT：永久重定向

Permanent Redirect RFC 7238, Section 3 (Experimental)

400

BAD_REQUEST：錯(cuò)誤請(qǐng)求

HTTP/1.1 RFC 7231, 6.5.1 節(jié)

401

UNAUTHORIZED：未授權(quán)

HTTP/1.1 Authentication RFC 7235, 3.1 節(jié)

402

PAYMENT_REQUIRED：保留，將來使用

HTTP/1.1 RFC 7231, 6.5.2 節(jié)

403

FORBIDDEN：禁止

HTTP/1.1 RFC 7231, 6.5.3 節(jié)

404

NOT_FOUND：沒有找到

HTTP/1.1 RFC 7231, 6.5.4 節(jié)

405

METHOD_NOT_ALLOWED：該請(qǐng)求方法不允許

HTTP/1.1 RFC 7231, 6.5.5 節(jié)

406

NOT_ACCEPTABLE：不可接受

HTTP/1.1 RFC 7231, 6.5.6 節(jié)

407

PROXY_AUTHENTICATION_REQUIRED：要求使用代理驗(yàn)明正身

HTTP/1.1 Authentication RFC 7235, 3.1 節(jié)

408

REQUEST_TIMEOUT：請(qǐng)求超時(shí)

HTTP/1.1 RFC 7231, 6.5.7 節(jié)

409

CONFLICT：沖突

HTTP/1.1 RFC 7231, 6.5.8 節(jié)

410

GONE：已經(jīng)不在了

HTTP/1.1 RFC 7231, 6.5.9 節(jié)

411

LENGTH_REQUIRED：長(zhǎng)度要求

HTTP/1.1 RFC 7231, 6.5.10 節(jié)

412

PRECONDITION_FAILED：前提條件錯(cuò)誤

HTTP/1.1 RFC 7232, 4.2 節(jié)

413

REQUEST_ENTITY_TOO_LARGE：請(qǐng)求體太大了

HTTP/1.1 RFC 7231, 6.5.11 節(jié)

414

REQUEST_URI_TOO_LONG：請(qǐng)求URI太長(zhǎng)了

HTTP/1.1 RFC 7231, 6.5.12 節(jié)

415

UNSUPPORTED_MEDIA_TYPE：不支持的媒體格式

HTTP/1.1 RFC 7231, 6.5.13 節(jié)

416

REQUESTED_RANGE_NOT_SATISFIABLE

HTTP/1.1 Range Requests RFC 7233, 4.4 節(jié)

417

EXPECTATION_FAILED：期望失敗

HTTP/1.1 RFC 7231, 6.5.14 節(jié)

418

IM_A_TEAPOT

HTCPCP/1.0 RFC 2324, Section 2.3.2

421

MISDIRECTED_REQUEST

HTTP/2 RFC 7540, 9.1.2 節(jié)

422

UNPROCESSABLE_ENTITY：可加工實(shí)體

WebDAV RFC 4918, 11.2 節(jié)

423

LOCKED：鎖著

WebDAV RFC 4918, 11.3 節(jié)

424

FAILED_DEPENDENCY：失敗的依賴

WebDAV RFC 4918, 11.4 節(jié)

425

TOO_EARLY

使用 HTTP RFC 8470 中的早期數(shù)據(jù)

426

UPGRADE_REQUIRED：升級(jí)需要

HTTP/1.1 RFC 7231, 6.5.15 節(jié)

428

PRECONDITION_REQUIRED：先決條件要求

Additional HTTP Status Codes RFC 6585

429

TOO_MANY_REQUESTS：太多的請(qǐng)求

Additional HTTP Status Codes RFC 6585

431

REQUEST_HEADER_FIELDS_TOO_LARGE：請(qǐng)求頭太大

Additional HTTP Status Codes RFC 6585

451

UNAVAILABLE_FOR_LEGAL_REASONS

HTTP 狀態(tài)碼用于報(bào)告法律障礙 RFC 7725

500

INTERNAL_SERVER_ERROR：內(nèi)部服務(wù)錯(cuò)誤

HTTP/1.1 RFC 7231, 6.6.1 節(jié)

501

NOT_IMPLEMENTED：不可執(zhí)行

HTTP/1.1 RFC 7231, 6.6.2 節(jié)

502

BAD_GATEWAY：無效網(wǎng)關(guān)

HTTP/1.1 RFC 7231, 6.6.3 節(jié)

503

SERVICE_UNAVAILABLE：服務(wù)不可用

HTTP/1.1 RFC 7231, 6.6.4 節(jié)

504

GATEWAY_TIMEOUT：網(wǎng)關(guān)超時(shí)

HTTP/1.1 RFC 7231, 6.6.5 節(jié)

505

HTTP_VERSION_NOT_SUPPORTED：HTTP版本不支持

HTTP/1.1 RFC 7231, 6.6.6 節(jié)

506

VARIANT_ALSO_NEGOTIATES：服務(wù)器存在內(nèi)部配置錯(cuò)誤

透明內(nèi)容協(xié)商在： HTTP RFC 2295, 8.1 節(jié)（實(shí)驗(yàn)性）

507

INSUFFICIENT_STORAGE：存儲(chǔ)不足

WebDAV RFC 4918, 11.5 節(jié)

508

LOOP_DETECTED：循環(huán)檢測(cè)

WebDAV Binding Extensions RFC 5842, 7.2 節(jié)（實(shí)驗(yàn)性）

510

NOT_EXTENDED：不擴(kuò)展

WebDAV Binding Extensions RFC 5842, 7.2 節(jié)（實(shí)驗(yàn)性）

511

NETWORK_AUTHENTICATION_REQUIRED：要求網(wǎng)絡(luò)身份驗(yàn)證

Additional HTTP Status Codes RFC 6585, 6 節(jié)

為了保持向后兼容性，枚舉值也以常量形式出現(xiàn)在 http.client 模塊中，。 枚舉名等于常量名 (例如 http.HTTPStatus.OK 也可以是 http.client.OK)。

在 3.7 版更改: 添加了 421 MISDIRECTED_REQUEST 狀態(tài)碼。

3.8 新版功能: 添加了 451 UNAVAILABLE_FOR_LEGAL_REASONS 狀態(tài)碼。

3.9 新版功能: 增加了 103 EARLY_HINTS, 418 IM_A_TEAPOT 和 425 TOO_EARLY 狀態(tài)碼

class http.HTTPMethod?

3.11 新版功能.

A subclass of enum.StrEnum that defines a set of HTTP methods and descriptions written in English.

用法：

>>>
>>> from http import HTTPMethod
>>> HTTMethod.GET
HTTMethod.GET
>>> HTTMethod.GET == 'GET'
True
>>> HTTMethod.GET.value
'GET'
>>> HTTMethod.GET.description
'Transfer a current representation of the target resource.'
>>> list(HTTPMethod)
[HTTPMethod.GET, HTTPMethod.HEAD, ...]

HTTP methods?

Supported, IANA-registered methods available in http.HTTPMethod are:

Method

映射名

詳情

GET

GET

HTTP/1.1 RFC 7231, Section 4.3.1

HEAD

HEAD

HTTP/1.1 RFC 7231, Section 4.3.2

POST

POST

HTTP/1.1 RFC 7231, Section 4.3.3

PUT

PUT

HTTP/1.1 RFC 7231, Section 4.3.4

DELETE

DELETE

HTTP/1.1 RFC 7231, Section 4.3.5

CONNECT

CONNECT

HTTP/1.1 RFC 7231, Section 4.3.6

OPTIONS

OPTIONS

HTTP/1.1 RFC 7231, Section 4.3.7

TRACE

TRACE

HTTP/1.1 RFC 7231, Section 4.3.8

PATCH

PATCH

HTTP/1.1 RFC 5789