`http` — Módulos HTTP¶

http é um pacote que coleta vários módulos para trabalhar com o Protocolo de Transferência de Hipertexto:

http.client é um cliente de protocolo HTTP de baixo nível; para abertura de URL de alto nível, use urllib.request
http.server contém classes básicas de servidor HTTP baseadas em socketserver
http.cookies tem utilitários para implementar gerenciamento de estado com cookies
http.cookiejar provê persistência de cookies

O módulo http também define os seguintes enums que podem ajudar você a trabalhar com os status code http relacionados:

class http.HTTPStatus¶

Adicionado na versão 3.5.

Subclasse de enum.IntEnum que define um conjunto de códigos de estado HTTP, frases de razão e descrições longas em inglês.

Uso:

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

Códigos de estado HTTP¶

Os códigos de estado registrados no IANA suportados e disponíveis em http.HTTPStatus são:

Código	Nome da enumeração	Detalhes (em inglês)
`100`	`CONTINUE`	HTTP/1.1 RFC 7231, Seção 6.2.1
`101`	`SWITCHING_PROTOCOLS`	HTTP/1.1 RFC 7231, Seção 6.2.2
`102`	`PROCESSING`	WebDAV RFC 2518, Seção 10.1
`103`	`EARLY_HINTS`	An HTTP Status Code for Indicating Hints RFC 8297
`200`	`OK`	HTTP/1.1 RFC 7231, Seção 6.3.1
`201`	`CREATED`	HTTP/1.1 RFC 7231, Seção 6.3.2
`202`	`ACCEPTED`	HTTP/1.1 RFC 7231, Seção 6.3.3
`203`	`NON_AUTHORITATIVE_INFORMATION`	HTTP/1.1 RFC 7231, Seção 6.3.4
`204`	`NO_CONTENT`	HTTP/1.1 RFC 7231, Seção 6.3.5
`205`	`RESET_CONTENT`	HTTP/1.1 RFC 7231, Seção 6.3.6
`206`	`PARTIAL_CONTENT`	HTTP/1.1 RFC 7233, Seção 4.1
`207`	`MULTI_STATUS`	WebDAV RFC 4918, Seção 11.1
`208`	`ALREADY_REPORTED`	WebDAV Binding Extensions RFC 5842, Seção 7.1 (Experimental)
`226`	`IM_USED`	Delta Encoding in HTTP RFC 3229, Seção 10.4.1
`300`	`MULTIPLE_CHOICES`	HTTP/1.1 RFC 7231, Seção 6.4.1
`301`	`MOVED_PERMANENTLY`	HTTP/1.1 RFC 7231, Seção 6.4.2
`302`	`FOUND`	HTTP/1.1 RFC 7231, Seção 6.4.3
`303`	`SEE_OTHER`	HTTP/1.1 RFC 7231, Seção 6.4.4
`304`	`NOT_MODIFIED`	HTTP/1.1 RFC 7232, Seção 4.1
`305`	`USE_PROXY`	HTTP/1.1 RFC 7231, Seção 6.4.5
`307`	`TEMPORARY_REDIRECT`	HTTP/1.1 RFC 7231, Seção 6.4.7
`308`	`PERMANENT_REDIRECT`	Redirecionamento Permanente RFC 7238, Seção 3 (Experimental)
`400`	`BAD_REQUEST`	HTTP/1.1 RFC 7231, Seção 6.5.1
`401`	`UNAUTHORIZED`	Autenticação HTTP/1.1 RFC 7235, Seção 3.1
`402`	`PAYMENT_REQUIRED`	HTTP/1.1 RFC 7231, Seção 6.5.2
`403`	`FORBIDDEN`	HTTP/1.1 RFC 7231, Seção 6.5.3
`404`	`NOT_FOUND`	HTTP/1.1 RFC 7231, Seção 6.5.4
`405`	`METHOD_NOT_ALLOWED`	HTTP/1.1 RFC 7231, Seção 6.5.5
`406`	`NOT_ACCEPTABLE`	HTTP/1.1 RFC 7231, Seção 6.5.6
`407`	`PROXY_AUTHENTICATION_REQUIRED`	Autenticação HTTP/1.1 RFC 7235, Seção 3.2
`408`	`REQUEST_TIMEOUT`	HTTP/1.1 RFC 7231, Seção 6.5.7
`409`	`CONFLICT`	HTTP/1.1 RFC 7231, Seção 6.5.8
`410`	`GONE`	HTTP/1.1 RFC 7231, Seção 6.5.9
`411`	`LENGTH_REQUIRED`	HTTP/1.1 RFC 7231, Seção 6.5.10
`412`	`PRECONDITION_FAILED`	HTTP/1.1 RFC 7232, Seção 4.2
`413`	`REQUEST_ENTITY_TOO_LARGE`	HTTP/1.1 RFC 7231, Seção 6.5.11
`414`	`REQUEST_URI_TOO_LONG`	HTTP/1.1 RFC 7231, Seção 6.5.12
`415`	`UNSUPPORTED_MEDIA_TYPE`	HTTP/1.1 RFC 7231, Seção 6.5.13
`416`	`REQUESTED_RANGE_NOT_SATISFIABLE`	Alcance de Requisições HTTP/1.1 RFC 7233, Seção 4.4
`417`	`EXPECTATION_FAILED`	HTTP/1.1 RFC 7231, Seção 6.5.14
`418`	`IM_A_TEAPOT`	HTCPCP/1.0 RFC 2324, Seção 2.3.2
`421`	`MISDIRECTED_REQUEST`	HTTP/2 RFC 7540, Seção 9.1.2
`422`	`UNPROCESSABLE_ENTITY`	WebDAV RFC 4918, Section 11.2
`423`	`LOCKED`	WebDAV RFC 4918, Seção 11.3
`424`	`FAILED_DEPENDENCY`	WebDAV RFC 4918, Seção 11.4
`425`	`TOO_EARLY`	Using Early Data in HTTP RFC 8470
`426`	`UPGRADE_REQUIRED`	HTTP/1.1 RFC 7231, Seção 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
`451`	`UNAVAILABLE_FOR_LEGAL_REASONS`	An HTTP Status Code to Report Legal Obstacles RFC 7725
`500`	`INTERNAL_SERVER_ERROR`	HTTP/1.1 RFC 7231, Seção 6.6.1
`501`	`NOT_IMPLEMENTED`	HTTP/1.1 RFC 7231, Seção 6.6.2
`502`	`BAD_GATEWAY`	HTTP/1.1 RFC 7231, Seção 6.6.3
`503`	`SERVICE_UNAVAILABLE`	HTTP/1.1 RFC 7231, Seção 6.6.4
`504`	`GATEWAY_TIMEOUT`	HTTP/1.1 RFC 7231, Seção 6.6.5
`505`	`HTTP_VERSION_NOT_SUPPORTED`	HTTP/1.1 RFC 7231, Seção 6.6.6
`506`	`VARIANT_ALSO_NEGOTIATES`	Transparent Content Negotiation in HTTP RFC 2295, Seção 8.1 (Experimental)
`507`	`INSUFFICIENT_STORAGE`	WebDAV RFC 4918, Seção 11.5
`508`	`LOOP_DETECTED`	WebDAV Binding Extensions RFC 5842, Seção 7.2 (Experimental)
`510`	`NOT_EXTENDED`	An HTTP Extension Framework RFC 2774, Seção 7 (Experimental)
`511`	`NETWORK_AUTHENTICATION_REQUIRED`	Additional HTTP Status Codes RFC 6585, Seção 6

Para preservar a retrocompatibilidade, os valores de enumerações também estão presentes no módulo http.client na forma de constantes. O nome da enumeração é igual ao da constante (i.e., http.HTTPStatus.OK também está disponível como http.client.OK).

Alterado na versão 3.7: Adicionado código de estado 421 MISDIRECTED_REQUEST.

Adicionado na versão 3.8: Adicionado código de estado 451 UNAVAILABLE_FOR_LEGAL_REASONS.

Adicionado na versão 3.9: Adicionado os códigos de estado 103 EARLY_HINTS, 418 IM_A_TEAPOT e 425 TOO_EARLY.

Categoria de estado HTTP¶

Adicionado na versão 3.12.

Os valores das enumerações possuem várias propriedades que indicam a categoria do estado HTTP.

Propriedade	Indica que	Detalhes (em inglês)
`is_informational`	`100 <= estado <= 199`	HTTP/1.1 RFC 7231, Section 6
`is_success`	`200 <= estado <= 299`	HTTP/1.1 RFC 7231, Section 6
`is_redirection`	`300 <= estado <= 399`	HTTP/1.1 RFC 7231, Section 6
`is_client_error`	`400 <= estado <= 499`	HTTP/1.1 RFC 7231, Section 6
`is_server_error`	`500 <= estado <= 599`	HTTP/1.1 RFC 7231, Section 6

Uso:

>>> from http import HTTPStatus
>>> HTTPStatus.OK.is_success
True
>>> HTTPStatus.OK.is_client_error
False

class http.HTTPMethod¶

Adicionado na versão 3.11.

Subclasse de enum.StrEnum que define um conjunto de métodos HTTP e suas respectivas descrições em inglês.

Uso:

>>> from http import HTTPMethod
>>>
>>> HTTPMethod.GET
<HTTPMethod.GET>
>>> HTTPMethod.GET == 'GET'
True
>>> HTTPMethod.GET.value
'GET'
>>> HTTPMethod.GET.description
'Retrieve the target.'
>>> list(HTTPMethod)
[<HTTPMethod.CONNECT>,
 <HTTPMethod.DELETE>,
 <HTTPMethod.GET>,
 <HTTPMethod.HEAD>,
 <HTTPMethod.OPTIONS>,
 <HTTPMethod.PATCH>,
 <HTTPMethod.POST>,
 <HTTPMethod.PUT>,
 <HTTPMethod.TRACE>]

Métodos HTTP¶

Os métodos registrados no IANA suportados e disponíveis em http.HTTPMethod são:

Método	Nome da enumeração	Detalhes (em inglês)
`GET`	`GET`	HTTP/1.1 RFC 7231, Section 4.3.1
`HEAD`	`HEAD`	HTTP/1.1 RFC 7231, Section 4.3.2
`POST`	`POST`	HTTP/1.1 RFC 7231, Section 4.3.3
`PUT`	`PUT`	HTTP/1.1 RFC 7231, Section 4.3.4
`DELETE`	`DELETE`	HTTP/1.1 RFC 7231, Section 4.3.5
`CONNECT`	`CONNECT`	HTTP/1.1 RFC 7231, Section 4.3.6
`OPTIONS`	`OPTIONS`	HTTP/1.1 RFC 7231, Section 4.3.7
`TRACE`	`TRACE`	HTTP/1.1 RFC 7231, Section 4.3.8
`PATCH`	`PATCH`	HTTP/1.1 RFC 5789

`http` — Módulos HTTP¶

Códigos de estado HTTP¶

Categoria de estado HTTP¶

Métodos HTTP¶

Tabela de Conteúdo

Tópico anterior

Próximo tópico

Esta página

http — Módulos HTTP¶

Códigos de estado HTTP¶

Categoria de estado HTTP¶

Métodos HTTP¶

`http` — Módulos HTTP¶