http
--- HTTP 模組¶
http
是一個收集了多個用於處理超文本傳輸協定 (HyperText Transfer Protocol) 之模組 (module) 的套件:
http.client
是一個低階的 HTTP 協定客戶端;對於高階的 URL 訪問請使用urllib.request
http.server
包含基於socketserver
的基本 HTTP 伺服器類別http.cookies
包含通過 cookies 實作狀態管理的工具程式 (utilities)http.cookiejar
提供了 cookies 的持續留存 (persistence)
http
也是一個透過 http.HTTPStatus
枚舉 (enum) 定義一些 HTTP 狀態碼及其相關訊息的模組:
-
class
http.
HTTPStatus
¶ 3.5 版新加入.
enum.IntEnum
的子類別,它定義了一組 HTTP 狀態碼、原理短語 (reason phrase) 以及英文長描述。用法:
>>> 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 狀態碼¶
http.HTTPStatus
當中,已支援並且有於 IANA 註冊的狀態碼有:
狀態碼 |
枚舉名稱 |
詳情 |
---|---|---|
|
|
HTTP/1.1 RFC 7231,6.2.1 節 |
|
|
HTTP/1.1 RFC 7231,6.2.2 節 |
|
|
WebDAV RFC 2518,10.1 節 |
|
|
用於指定提示 (Indicating Hints) RFC 8297 的 HTTP 狀態碼 |
|
|
HTTP/1.1 RFC 7231,6.3.1 節 |
|
|
HTTP/1.1 RFC 7231,6.3.2 節 |
|
|
HTTP/1.1 RFC 7231,6.3.3 節 |
|
|
HTTP/1.1 RFC 7231,6.3.4 節 |
|
|
HTTP/1.1 RFC 7231,6.3.5 節 |
|
|
HTTP/1.1 RFC 7231,6.3.6 節 |
|
|
HTTP/1.1 RFC 7233,4.1 節 |
|
|
WebDAV RFC 4918,11.1 節 |
|
|
WebDAV 繫結擴充 (Binding Extensions) RFC 5842,7.1 節(實驗性) |
|
|
HTTP 中的差分編碼 RFC 3229,10.4.1 節 |
|
|
HTTP/1.1 RFC 7231,6.4.1 節 |
|
|
HTTP/1.1 RFC 7231,6.4.2 節 |
|
|
HTTP/1.1 RFC 7231,6.4.3 節 |
|
|
HTTP/1.1 RFC 7231,6.4.4 節 |
|
|
HTTP/1.1 RFC 7232,4.1 節 |
|
|
HTTP/1.1 RFC 7231,6.4.5 節 |
|
|
HTTP/1.1 RFC 7231,6.4.7 節 |
|
|
永久重定向 RFC 7238,3 節(實驗性) |
|
|
HTTP/1.1 RFC 7231,6.5.1 節 |
|
|
HTTP/1.1 身分驗證 (Authentication) RFC 7235,3.1 節 |
|
|
HTTP/1.1 RFC 7231,6.5.2 節 |
|
|
HTTP/1.1 RFC 7231,6.5.3 節 |
|
|
HTTP/1.1 RFC 7231,6.5.4 節 |
|
|
HTTP/1.1 RFC 7231,6.5.5 節 |
|
|
HTTP/1.1 RFC 7231,6.5.6 節 |
|
|
HTTP/1.1 身分驗證 RFC 7235,3.2 節 |
|
|
HTTP/1.1 RFC 7231,6.5.7 節 |
|
|
HTTP/1.1 RFC 7231,6.5.8 節 |
|
|
HTTP/1.1 RFC 7231,6.5.9 節 |
|
|
HTTP/1.1 RFC 7231,6.5.10 節 |
|
|
HTTP/1.1 RFC 7232,4.2 節 |
|
|
HTTP/1.1 RFC 7231,6.5.11 節 |
|
|
HTTP/1.1 RFC 7231,6.5.12 節 |
|
|
HTTP/1.1 RFC 7231,6.5.13 節 |
|
|
HTTP/1.1 範圍請求 (Range Requests) RFC 7233,4.4 節 |
|
|
HTTP/1.1 RFC 7231,6.5.14 節 |
|
|
HTCPCP/1.0 RFC 2324,Section 2.3.2 |
|
|
HTTP/2 RFC 7540,9.1.2 節 |
|
|
WebDAV RFC 4918,11.2 節 |
|
|
WebDAV RFC 4918,11.3 節 |
|
|
WebDAV RFC 4918,11.4 節 |
|
|
使用 HTTP 中的早期資料 RFC 8470 |
|
|
HTTP/1.1 RFC 7231,6.5.15 節 |
|
|
額外的 HTTP 狀態碼 RFC 6585 |
|
|
額外的 HTTP 狀態碼 RFC 6585 |
|
|
額外的 HTTP 狀態碼 RFC 6585 |
|
|
一個用來回報合法性障礙 (Legal Obstacles) 的 HTTP 狀態碼 RFC 7725 |
|
|
HTTP/1.1 RFC 7231,6.6.1 節 |
|
|
HTTP/1.1 RFC 7231,6.6.2 節 |
|
|
HTTP/1.1 RFC 7231,6.6.3 節 |
|
|
HTTP/1.1 RFC 7231,6.6.4 節 |
|
|
HTTP/1.1 RFC 7231,6.6.5 節 |
|
|
HTTP/1.1 RFC 7231,6.6.6 節 |
|
|
HTTP 中的透明內容協商 (Transparent Content Negotiation) RFC 2295,8.1 節(實驗性) |
|
|
WebDAV RFC 4918,11.5 節 |
|
|
WebDAV 繫結擴充 RFC 5842,7.2 節(實驗性) |
|
|
一個 HTTP 擴充框架 RFC 2774,7 節(實驗性) |
|
|
額外的 HTTP 狀態碼 RFC 6585,6 節 |
為了向後相容性,枚舉值也以常數形式出現在 http.client
模組中。枚舉名稱等於常數名稱(例如 http.HTTPStatus.OK
也可以是 http.client.OK
)。
3.7 版更變: 新增 421 MISDIRECTED_REQUEST
狀態碼。
3.8 版新加入: 新增 451 UNAVAILABLE_FOR_LEGAL_REASONS
狀態碼。
3.9 版新加入: 新增 103 EARLY_HINTS
、418 IM_A_TEAPOT
與 425 TOO_EARLY
狀態碼。