http — HTTP 모듈

소스 코드: Lib/http/__init__.py

---

http는 하이퍼텍스트 전송 프로토콜로 작업 하기 위한 여러 모듈을 수집하는 패키지입니다:

• http.client는 저수준 HTTP 프로토콜 클라이언트입니다. 고수준의 URL 열기는 urllib.request를 사용합니다

• http.server는 socketserver에 기반을 둔 기본적인 HTTP 서버 클래스를 포함합니다

• http.cookies는 쿠키를 사용하여 상태 관리를 구현하는 유틸리티가 있습니다

• http.cookiejar는 쿠키의 지속성을 제공합니다

http는 여러 HTTP 상태 코드와 관련 메시지를 http.HTTPStatus 열거형을 통해 정의하는 모듈이기도 합니다:

class http.HTTPStatus

버전 3.5에 추가.

HTTP 상태 코드, 이유 구문 그리고 긴 영문 설명의 집합을 정의하는 enum.IntEnum의 서브 클래스입니다.

사용법:

>>> 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 등록 상태 코드는 다음과 같습니다:

코드	열거 이름	세부 사항
100	CONTINUE	HTTP/1.1 RFC 7231, 섹션 6.2.1
101	SWITCHING_PROTOCOLS	HTTP/1.1 RFC 7231, 섹션 6.2.2
102	PROCESSING	WebDAV RFC 2518, 섹션 10.1
200	OK	HTTP/1.1 RFC 7231, 섹션 6.3.1
201	CREATED	HTTP/1.1 RFC 7231, 섹션 6.3.2
202	ACCEPTED	HTTP/1.1 RFC 7231, 섹션 6.3.3
203	NON_AUTHORITATIVE_INFORMATION	HTTP/1.1 RFC 7231, 섹션 6.3.4
204	NO_CONTENT	HTTP/1.1 RFC 7231, 섹션 6.3.5
205	RESET_CONTENT	HTTP/1.1 RFC 7231, 섹션 6.3.6
206	PARTIAL_CONTENT	HTTP/1.1 RFC 7233, 섹션 4.1
207	MULTI_STATUS	WebDAV RFC 4918, 섹션 11.1
208	ALREADY_REPORTED	WebDAV 바인딩 확장 RFC 5842, 섹션 7.1 (실험적)
226	IM_USED	HTTP의 델타 인코딩 RFC 3229, 섹션 10.4.1
300	MULTIPLE_CHOICES	HTTP/1.1 RFC 7231, 섹션 6.4.1
301	MOVED_PERMANENTLY	HTTP/1.1 RFC 7231, 섹션 6.4.2
302	FOUND	HTTP/1.1 RFC 7231, 섹션 6.4.3
303	SEE_OTHER	HTTP/1.1 RFC 7231, 섹션 6.4.4
304	NOT_MODIFIED	HTTP/1.1 RFC 7232, 섹션 4.1
305	USE_PROXY	HTTP/1.1 RFC 7231, 섹션 6.4.5
307	TEMPORARY_REDIRECT	HTTP/1.1 RFC 7231, 섹션 6.4.7
308	PERMANENT_REDIRECT	영구 리디렉션 RFC 7238, 섹션 3 (실험적)
400	BAD_REQUEST	HTTP/1.1 RFC 7231, 섹션 6.5.1
401	UNAUTHORIZED	HTTP/1.1 인증 RFC 7235, 섹션 3.1
402	PAYMENT_REQUIRED	HTTP/1.1 RFC 7231, 섹션 6.5.2
403	FORBIDDEN	HTTP/1.1 RFC 7231, 섹션 6.5.3
404	NOT_FOUND	HTTP/1.1 RFC 7231, 섹션 6.5.4
405	METHOD_NOT_ALLOWED	HTTP/1.1 RFC 7231, 섹션 6.5.5
406	NOT_ACCEPTABLE	HTTP/1.1 RFC 7231, 섹션 6.5.6
407	PROXY_AUTHENTICATION_REQUIRED	HTTP/1.1 인증 RFC 7235, 섹션 3.2
408	REQUEST_TIMEOUT	HTTP/1.1 RFC 7231, 섹션 6.5.7
409	CONFLICT	HTTP/1.1 RFC 7231, 섹션 6.5.8
410	GONE	HTTP/1.1 RFC 7231, 섹션 6.5.9
411	LENGTH_REQUIRED	HTTP/1.1 RFC 7231, 섹션 6.5.10
412	PRECONDITION_FAILED	HTTP/1.1 RFC 7232, 섹션 4.2
413	REQUEST_ENTITY_TOO_LARGE	HTTP/1.1 RFC 7231, 섹션 6.5.11
414	REQUEST_URI_TOO_LONG	HTTP/1.1 RFC 7231, 섹션 6.5.12
415	UNSUPPORTED_MEDIA_TYPE	HTTP/1.1 RFC 7231, 섹션 6.5.13
416	REQUESTED_RANGE_NOT_SATISFIABLE	HTTP/1.1 범위 요청 RFC 7233, 섹션 4.4
417	EXPECTATION_FAILED	HTTP/1.1 RFC 7231, 섹션 6.5.14
421	MISDIRECTED_REQUEST	HTTP/2 RFC 7540, 섹션 9.1.2
422	UNPROCESSABLE_ENTITY	WebDAV RFC 4918, 섹션 11.2
423	LOCKED	WebDAV RFC 4918, 섹션 11.3
424	FAILED_DEPENDENCY	WebDAV RFC 4918, 섹션 11.4
426	UPGRADE_REQUIRED	HTTP/1.1 RFC 7231, 섹션 6.5.15
428	PRECONDITION_REQUIRED	추가 HTTP 상태 코드 RFC 6585
429	TOO_MANY_REQUESTS	추가 HTTP 상태 코드 RFC 6585
431	REQUEST_HEADER_FIELDS_TOO_LARGE	추가 HTTP 상태 코드 RFC 6585
451	UNAVAILABLE_FOR_LEGAL_REASONS	법적 장애를 보고하는 HTTP 상태 코드 RFC 7725
500	INTERNAL_SERVER_ERROR	HTTP/1.1 RFC 7231, 섹션 6.6.1
501	NOT_IMPLEMENTED	HTTP/1.1 RFC 7231, 섹션 6.6.2
502	BAD_GATEWAY	HTTP/1.1 RFC 7231, 섹션 6.6.3
503	SERVICE_UNAVAILABLE	HTTP/1.1 RFC 7231, 섹션 6.6.4
504	GATEWAY_TIMEOUT	HTTP/1.1 RFC 7231, 섹션 6.6.5
505	HTTP_VERSION_NOT_SUPPORTED	HTTP/1.1 RFC 7231, 섹션 6.6.6
506	VARIANT_ALSO_NEGOTIATES	HTTP의 투명한 콘텐츠 협상 RFC 2295, 섹션 8.1 (실험적)
507	INSUFFICIENT_STORAGE	WebDAV RFC 4918, 섹션 11.5
508	LOOP_DETECTED	WebDAV 바인딩 확장 RFC 5842, 섹션 7.2 (실험적)
510	NOT_EXTENDED	HTTP 확장 프레임워크 RFC 2774, 섹션 7 (실험적)
511	NETWORK_AUTHENTICATION_REQUIRED	추가 HTTP 상태 코드 RFC 6585, 섹션 6

이전 버전과의 호환성을 유지하기 위해 열거값은 http.client 모듈에 상수 형태로도 있습니다. 열거명과 상수명은 동일합니다 (즉, http.HTTPStatus.OK는 http.client.OK로도 사용 가능합니다).

버전 3.7에서 변경: 421 MISDIRECTED_REQUEST 상태 코드 추가.

버전 3.8에 추가: 451 UNAVAILABLE_FOR_LEGAL_REASONS 상태 코드가 추가.