http —- HTTP 模块

源代码:Lib/http/init.py


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

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

  • class http.HTTPStatus

3.5 新版功能.

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

用法:

  1. >>> from http import HTTPStatus
  2. >>> HTTPStatus.OK
  3. <HTTPStatus.OK: 200>
  4. >>> HTTPStatus.OK == 200
  5. True
  6. >>> HTTPStatus.OK.value
  7. 200
  8. >>> HTTPStatus.OK.phrase
  9. 'OK'
  10. >>> HTTPStatus.OK.description
  11. 'Request fulfilled, document follows'
  12. >>> list(HTTPStatus)
  13. [<HTTPStatus.CONTINUE: 100>, <HTTPStatus.SWITCHING_PROTOCOLS: 101>, ...]

HTTP 状态码

已支持并且已在 http.HTTPStatusIANA 注册 的状态码有:

状态码映射名详情
100CONTINUEHTTP/1.1 RFC 7231, 6.2.1 节
101SWITCHING_PROTOCOLSHTTP/1.1 RFC 7231, 6.2.2 节
102PROCESSINGWebDAV RFC 2518, 10.1 节
200OKHTTP/1.1 RFC 7231, 6.3.1 节
201CREATEDHTTP/1.1 RFC 7231, 6.3.2 节
202ACCEPTEDHTTP/1.1 RFC 7231, 6.3.3 节
203NON_AUTHORITATIVE_INFORMATIONHTTP/1.1 RFC 7231, 6.3.4 节
204NO_CONTENTHTTP/1.1 RFC 7231, 6.3.5 节
205RESET_CONTENTHTTP/1.1 RFC 7231, 6.3.6 节
206PARTIAL_CONTENTHTTP/1.1 RFC 7233, 4.1 节
207MULTI_STATUSWebDAV RFC 4918, 11.1 节
208ALREADY_REPORTEDWebDAV Binding Extensions RFC 5842, 7.1 节(实验性)
226IM_USEDDelta Encoding in HTTP RFC 3229, 10.4.1 节
300MULTIPLE_CHOICES:有多种资源可选择HTTP/1.1 RFC 7231, 6.4.1 节
301MOVED_PERMANENTLY:永久移动HTTP/1.1 RFC 7231, 6.4.2 节
302FOUND:临时移动HTTP/1.1 RFC 7231, 6.4.3 节
303SEE_OTHER:已经移动HTTP/1.1 RFC 7231, 6.4.4 节
304NOT_MODIFIED:没有修改HTTP/1.1 RFC 7232, 4.1 节
305USE_PROXY:使用代理HTTP/1.1 RFC 7231, 6.4.5 节
307TEMPORARY_REDIRECT:临时重定向HTTP/1.1 RFC 7231, 6.4.7 节
308PERMANENT_REDIRECT:永久重定向Permanent Redirect RFC 7238, Section 3 (Experimental)
400BAD_REQUEST:错误请求HTTP/1.1 RFC 7231, 6.5.1 节
401UNAUTHORIZED:未授权HTTP/1.1 Authentication RFC 7235, 3.1 节
402PAYMENT_REQUIRED:保留,将来使用HTTP/1.1 RFC 7231, 6.5.2 节
403FORBIDDEN:禁止HTTP/1.1 RFC 7231, 6.5.3 节
404NOT_FOUND:没有找到HTTP/1.1 RFC 7231, 6.5.4 节
405METHOD_NOT_ALLOWED:该请求方法不允许HTTP/1.1 RFC 7231, 6.5.5 节
406NOT_ACCEPTABLE:不可接受HTTP/1.1 RFC 7231, 6.5.6 节
407PROXY_AUTHENTICATION_REQUIRED:要求使用代理验证身份HTTP/1.1 Authentication RFC 7235, 3.1 节
408REQUEST_TIMEOUT:请求超时HTTP/1.1 RFC 7231, 6.5.7 节
409CONFLICT:冲突HTTP/1.1 RFC 7231, 6.5.8 节
410GONE:已经不在了HTTP/1.1 RFC 7231, 6.5.9 节
411LENGTH_REQUIRED:长度要求HTTP/1.1 RFC 7231, 6.5.10 节
412PRECONDITION_FAILED:前提条件错误HTTP/1.1 RFC 7232, 4.2 节
413REQUEST_ENTITY_TOO_LARGE:请求体太大了HTTP/1.1 RFC 7231, 6.5.11 节
414REQUEST_URI_TOO_LONG:请求URI太长了HTTP/1.1 RFC 7231, 6.5.12 节
415UNSUPPORTED_MEDIA_TYPE:不支持的媒体格式HTTP/1.1 RFC 7231, 6.5.13 节
416REQUESTED_RANGE_NOT_SATISFIABLEHTTP/1.1 Range Requests RFC 7233, 4.4 节
417EXPECTATION_FAILED:期望失败HTTP/1.1 RFC 7231, 6.5.14 节
421MISDIRECTED_REQUESTHTTP/2 RFC 7540, 9.1.2 节
422UNPROCESSABLE_ENTITY:可加工实体WebDAV RFC 4918, 11.2 节
423LOCKED:锁着WebDAV RFC 4918, 11.3 节
424FAILED_DEPENDENCY:失败的依赖WebDAV RFC 4918, 11.4 节
426UPGRADE_REQUIRED:升级需要HTTP/1.1 RFC 7231, 6.5.15 节
428PRECONDITION_REQUIRED:先决条件要求Additional HTTP Status Codes RFC 6585
429TOO_MANY_REQUESTS:太多的请求Additional HTTP Status Codes RFC 6585
431REQUEST_HEADER_FIELDS_TOO_LARGE:请求头太大Additional HTTP Status Codes RFC 6585
451UNAVAILABLE_FOR_LEGAL_REASONSHTTP 状态码用于报告法律障碍 RFC 7725
500INTERNAL_SERVER_ERROR:内部服务错误HTTP/1.1 RFC 7231, 6.6.1 节
501NOT_IMPLEMENTED:不可执行HTTP/1.1 RFC 7231, 6.6.2 节
502BAD_GATEWAY:无效网关HTTP/1.1 RFC 7231, 6.6.3 节
503SERVICE_UNAVAILABLE:服务不可用HTTP/1.1 RFC 7231, 6.6.4 节
504GATEWAY_TIMEOUT:网关超时HTTP/1.1 RFC 7231, 6.6.5 节
505HTTP_VERSION_NOT_SUPPORTED:HTTP版本不支持HTTP/1.1 RFC 7231, 6.6.6 节
506VARIANT_ALSO_NEGOTIATES:服务器存在内部配置错误透明内容协商在: HTTP RFC 2295, 8.1 节(实验性)
507INSUFFICIENT_STORAGE:存储不足WebDAV RFC 4918, 11.5 节
508LOOP_DETECTED:循环检测WebDAV Binding Extensions RFC 5842, 7.2 节(实验性)
510NOT_EXTENDED:不扩展WebDAV Binding Extensions RFC 5842, 7.2 节(实验性)
511NETWORK_AUTHENTICATION_REQUIRED:要求网络身份验证Additional HTTP Status Codes RFC 6585, 6 节

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

在 3.7 版更改: 添加了 421 MISDIRECTED_REQUEST 状态码。

3.8 新版功能: 添加了 451 UNAVAILABLE_FOR_LEGAL_REASONS 状态码。