• http —- HTTP 模块
    • HTTP 状态码

    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 状态码,原理短语以及用英语书写的长描述文本。

    用法:

    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 状态码。