21.11. http — HTTP 模块
- 21.11.1. HTTP 状态码

21.11. http — HTTP 模块

源代码: Lib/http/__init__.py

http 是一个包，它收集了多个用于处理超文本传输协议的模块:

http.client 是一个低层级的 HTTP 协议客户端；对于高层级的 URL 访问请使用 urllib.request
http.server 包含基于 socketserver 的基本 HTTP 服务类
http.cookies 包含一些有用来实现通过 cookies 进行状态管理的工具
http.cookiejar 提供了 cookies 的持久化

http 也是一个通过 http.HTTPStatus 枚举定义了一些 HTTP 状态码以及相关联消息的模块

class http.HTTPStatus

3.5 新版功能.

enum.IntEnum 的子类，它定义了组 HTTP 状态码，原理短语以及用英语书写的长描述文本。

用法:

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

21.11.1. HTTP 状态码

已支持并且已在 http.HTTPStatus IANA 注册的状态码有：

双字母代码	映射名	详情
`100`	`CONTINUE`：继续	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`: 没有内容	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`：永久移动	HTTP/1.1 RFC 7231, Section 6.4.2
`302`	`FOUND`：临时移动	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`：永久重定向	Permanent Redirect RFC 7238, Section 3 (Experimental)
`400`	`BAD_REQUEST`：错误请求	HTTP/1.1 RFC 7231, Section 6.5.1
`401`	`UNAUTHORIZED`：未授权	HTTP/1.1 Authentication RFC 7235, Section 3.1
`402`	`PAYMENT_REQUIRED`：保留，将来使用	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`：该请求方法不允许	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`	`CONFLICT`：冲突	HTTP/1.1 RFC 7231, Section 6.5.8
`410`	`GONE`：已经不在了	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`：请求URI太长了	HTTP/1.1 RFC 7231, Section 6.5.12
`415`	`UNSUPPORTED_MEDIA_TYPE`：不支持的媒体格式	HTTP/1.1 RFC 7231, Section 6.5.13
`416`	`REQUEST_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
`422`	`UNPROCESSABLE_ENTITY`：可加工实体	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`：升级需要	HTTP/1.1 RFC 7231, Section 6.5.15
`428`	`PRECONDITION_REQUIRED`：先决条件要求	Additional HTTP Status Codes RFC 6585
`429`	`TOO_MANY_REQUESTS`：太多的请求	Additional HTTP Status Codes RFC 6585
`431`	`REQUEST_HEADER_FIELDS_TOO_LARGE`：请求头太大	Additional HTTP Status Codes RFC 6585
`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`	`SERVICE_UNAVAILABLE`：服务不可用	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版本不支持	HTTP/1.1 RFC 7231, Section 6.6.6
`506`	`VARIANT_ALSO_NEGOTIATES`：服务器存在内部配置错误	透明内容协商在： HTTP RFC 2295, Section 8.1 (实验性的)
`507`	`INSUFFICIENT_STORAGE`：存储不足	WebDAV RFC 4918, Section 11.5
`508`	`LOOP_DETECTED`：循环检测	WebDAV Binding Extensions RFC 5842, Section 7.2 (Experimental)
`510`	`NOT_EXTENDED`：不扩展	An HTTP Extension Framework RFC 2774, Section 7 (Experimental)
`511`	`NETWORK_AUTHENTICATION_REQUIRED`：要求网络身份验证	Additional HTTP Status Codes RFC 6585, Section 6

为了保持向后兼容性，枚举值也以常量形式出现在 http.client 模块中，。枚举名等于常量名 (例如 http.HTTPStatus.OK 也可以是 http.client.OK)。