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 包含一些有用來(lái)實(shí)現(xiàn)通過(guò) cookies 進(jìn)行狀態(tài)管理的工具

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

http 也是一個(gè)通過(guò) http.HTTPStatus 枚舉定義了一些 HTTP 狀態(tài)碼以及相關(guān)聯(lián)消息的模塊

class http.HTTPStatus?

3.5 新版功能.

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

用法:

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

已支持并且已在 http.HTTPStatus IANA 注冊(cè) 的狀態(tài)碼有:

雙字母代碼

映射名

詳情

100

CONTINUE:繼續(xù)

HTTP/1.1 RFC 7231, Section 6.2.1

101

SWITCHING_PROTOCOLS

HTTP/1.1 RFC 7231, Section 6.2.2

102

PROCESSING

WebDAV RFC 2518, Section 10.1

200

OK

HTTP/1.1 RFC 7231, Section 6.3.1

201

CREATED

HTTP/1.1 RFC 7231, Section 6.3.2

202

ACCEPTED

HTTP/1.1 RFC 7231, Section 6.3.3

203

NON_AUTHORITATIVE_INFORMATION

HTTP/1.1 RFC 7231, Section 6.3.4

204

NO_CONTENT: 沒有內(nèi)容

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

MULTI_STATUS

WebDAV RFC 4918, Section 11.1

208

ALREADY_REPORTED

WebDAV Binding Extensions RFC 5842, Section 7.1 (Experimental)

226

IM_USED

Delta Encoding in HTTP RFC 3229, Section 10.4.1

300

MULTIPLE_CHOICES:有多種資源可選擇

HTTP/1.1 RFC 7231, Section 6.4.1

301

MOVED_PERMANENTLY:永久移動(dòng)

HTTP/1.1 RFC 7231, Section 6.4.2

302

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

HTTP/1.1 RFC 7231, Section 6.4.3

303

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

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:臨時(shí)重定向

HTTP/1.1 RFC 7231, Section 6.4.7

308

PERMANENT_REDIRECT:永久重定向

Permanent Redirect RFC 7238, Section 3 (Experimental)

400

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

HTTP/1.1 RFC 7231, Section 6.5.1

401

UNAUTHORIZED:未授權(quán)

HTTP/1.1 Authentication RFC 7235, Section 3.1

402

PAYMENT_REQUIRED:保留,將來(lái)使用

HTTP/1.1 RFC 7231, Section 6.5.2

403

FORBIDDEN:禁止

HTTP/1.1 RFC 7231, Section 6.5.3

404

NOT_FOUND:沒有找到

HTTP/1.1 RFC 7231, Section 6.5.4

405

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

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:要求使用代理驗(yàn)明正身

HTTP/1.1 Authentication RFC 7235, Section 3.2

408

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

HTTP/1.1 RFC 7231, Section 6.5.7

409

CONFLICT:沖突

HTTP/1.1 RFC 7231, Section 6.5.8

410

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

HTTP/1.1 RFC 7231, Section 6.5.9

411

LENGTH_REQUIRED:長(zhǎng)度要求

HTTP/1.1 RFC 7231, Section 6.5.10

412

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

HTTP/1.1 RFC 7232, Section 4.2

413

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

HTTP/1.1 RFC 7231, Section 6.5.11

414

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

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

421

MISDIRECTED_REQUEST

HTTP/2 RFC 7540, Section 9.1.2

422

UNPROCESSABLE_ENTITY:可加工實(shí)體

WebDAV RFC 4918, Section 11.2

423

LOCKED:鎖著

WebDAV RFC 4918, Section 11.3

424

FAILED_DEPENDENCY:失敗的依賴

WebDAV RFC 4918, Section 11.4

426

UPGRADE_REQUIRED:升級(jí)需要

HTTP/1.1 RFC 7231, Section 6.5.15

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

500

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

HTTP/1.1 RFC 7231, Section 6.6.1

501

NOT_IMPLEMENTED:不可執(zhí)行

HTTP/1.1 RFC 7231, Section 6.6.2

502

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

HTTP/1.1 RFC 7231, Section 6.6.3

503

SERVICE_UNAVAILABLE:服務(wù)不可用

HTTP/1.1 RFC 7231, Section 6.6.4

504

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

HTTP/1.1 RFC 7231, Section 6.6.5

505

HTTP_VERSION_NOT_SUPPORTED:HTTP版本不支持

HTTP/1.1 RFC 7231, Section 6.6.6

506

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

透明內(nèi)容協(xié)商在: HTTP RFC 2295, Section 8.1 (實(shí)驗(yàn)性的)

507

INSUFFICIENT_STORAGE:存儲(chǔ)不足

WebDAV RFC 4918, Section 11.5

508

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

WebDAV Binding Extensions RFC 5842, Section 7.2 (Experimental)

510

NOT_EXTENDED:不擴(kuò)展

An HTTP Extension Framework RFC 2774, Section 7 (Experimental)

511

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

Additional HTTP Status Codes RFC 6585, Section 6

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

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