Cabeçalhos HTTP

Esta tradução está incompleta. Ajude a traduzir este artigo em inglês

Os cabeçalhos HTTP permitem que o cliente e o servidor passem informações adicionais com a solicitação ou a resposta HTTP. Um cabeçalho de solicitação é composto por seu nome case-insensitive (não diferencia letras maiúsculas e minúsculas), seguido por dois pontos ':' e pelo seu valor (sem quebras de linha).  Espaços em branco antes do valor serão ignorados.

Cabeçalhos proprietários personalizados podem ser adicionados usando o prefixo 'X-', mas essa convenção foi descontinuada em Junho de 2012, devido aos inconvenientes que causou quando os campos não-padronizados tornaram-se padronizados na RFC 6648; outros estão listados em um registro IANA, cujo o conteúdo original foi definido na RFC 4229. O IANA também mantém o registro das propostas de novas mensagens de cabeçalhos HTTP.

Cabeçalhos podem ser classificados de acordo com os seus contextos:

  • Cabeçalho genérico: Cabeçalhos que podem ser usados tanto em solicitações quanto em respostas, porém sem relação com os dados eventualmente transmitidos no corpo da mensagem.
  • Cabeçalho de solicitação: Cabeçalhos contendo mais informação sobre o recurso a ser obtido ou sobre o próprio cliente.
  • Cabeçalho de resposta: Cabeçalhos contendo informação adicional sobre a solicitação, como a sua localização ou sobre o servidor.
  • Cabeçalho de entidade: Cabeçalhos contendo mais informação sobre o conteúdo da entidade, como o tamanho do conteúdo ou o seu MIME-type.

Cabeçalhos também podem ser classificados de acordo com a forma que são manipulados por proxies.

End-to-end headers
Esses cabeçalhos devem ser transmitidos para o destinatário final da mensagem; isso é, o servidor em caso de solicitação ou o cliente caso resposta. Proxies intermediários devem reenviar cabeçalhos de end-to-end sem alterações e caches devem armazená-los.
Hop-by-hop headers
Esses cabeçalhos são significativos apenas para uma única conexão a nível de transporte e não devem ser reenviados por proxies ou armazenados em cache. Tais cabeçalhos são: Connection, Keep-Alive, Proxy-Authenticate, Proxy-Authorization, TE, Trailer, Transfer-Encoding and Upgrade. Observe que apenas cabeçalhos hop-by-hop podem ser definidos utilizando o cabeçalho genérico Connection.

A lista a seguir resume os cabeçalhos HTTP pela categoria de uso. Para uma lista alfabética, utilize o menu à esquerda.

Autenticação

WWW-Authenticate
Define o método de autenticação que deve ser utilizado para conseguir acesso ao recurso.
Authorization
Contém as credenciais para autenticar um User-Agent com o servidor.
Proxy-Authenticate
Define o método de autenticação que deve ser utilizado para conseguir acesso ao recurso por trás de um servidor Proxy.
Proxy-Authorization
Contém as credenciais para autenticar um User-Agent com o servidor Proxy.

Caching

Age
O tempo em segundos em que o objeto esteve em um cache de proxy.
Cache-Control
Especifica diretivas para mecanismos de cache em requisições e respostas.
Expires
A data/hora depois que a resposta é considerada obsoleta.
Pragma
Cabeçalho específico da implementação que pode ter varios efeitos em qualquer lugar ao longo da sequência de requisição-resposta. Usado  para compatibilidade de versões anteriores com caches HTTP/1.0 onde o header Cache-Control ainda não está presente.
Warning
Um campo de alerta geral contendo informações sobre possíveis problemas.

Client hints

O recurso HTTP Client hints ainda está em desenvolvimento. A documentação está disponível no site do HTTP working group.

Accept-CH
Os servidores podem dar suporte para o Client hints usando o campo de cabeçalho Accept-CH ou um elemento HTML <meta> equivalente com atributo http-equiv ([HTML5]).
Content-DPR
Os servidores podem solicitar ao cliente que lembre-se do conjunto de Client hints que o servidor dá suporte por um período de tempo especificado, para permitir a entrega de Client hints em solicitações seguidas ao servidor de origem([RFC6454]).
DPR
...
Downlink
...
Save-Data
...
Viewport-Width
...
Width
...

Condicionais

Last-Modified
É um validador, a última data de modificação de um recurso, usado para comparar várias versões de um mesmo recurso. É menos preciso que o ETag, mas é mais fácil calcular em alguns ambientes. Requisições condicionais usando If-Modified-Since e If-Unmodified-Since usam esse valor para modificar o comportamento da requisição.
ETag
É um validador, uma string única identificando a versão do recurso. Requisições condicionais usando If-Match e If-None-Match usam esse valor para modificar o comportamento da requisição.
If-Match
Faz a requisição condicional e aplica o método apenas se o recurso armazenado corresponder a uma das ETags fornecidas.
If-None-Match
Faz a requisição condicional e aplica o método apenas se o recurso armazenado não corresponder a nenhuma das ETags fornecidas. É usado para atualizar caches ( para requisições seguras), ou para prevenir o upload de um novo recurso quando este já existe.
If-Modified-Since
Faz a requisição condicional e espera a entidade ser transmitida somente se tiver sido modificada após a data especificada. É usado para transmitir dados somente se o cache estiver desatualizado.
If-Unmodified-Since
Faz a requisição condicional e espera a entidade ser transmitida somente se não tiver sido modificada após a data especificada. É usado para garantir a coerência de um novo fragmento de um intervalo específico com os anteriores, ou para implementar um Sistema de Controle de concorrência otimista ao modificar os documentos existentes.

Gerenciamento de Conexão

Connection
Controla se uma conexão de rede continua ou não aberta após o término da transação atual
Keep-Alive
Controla por quanto tempo uma conexão persistente deve permanecer aberta.

Negociação de conteúdo

Accept
Informa ao servidor sobre os tipos de dados que podem ser enviados de volta. Isto é MIME-type.
Accept-Charset
Informa ao servidor sobre qual conjunto de caracter o cliente é capaz de entender.
Accept-Encoding
Informa ao servidor sobre o algoritmo de codificação, geralmente um algoritmo de compressão, isto pode ser usado no recurso enviado de volta.
Accept-Language
Informa ao servidor sobre a linguagem que é esperada que o servidor envie de volta. Esta é uma dica e não está necessariamente sob controle total do usuário: o servidor deve sempre prestar atenção para não sobrepor uma escolha explícita do usuário (como selecionar uma linguagem em uma lista suspensa).

Controles

Expect
...
Max-Forwards
...

Cookies

Cookie
Contém cookies HTTP armazenados préviamente enviados pelo servidor com o cabeçalho Set-Cookie.
Set-Cookie
Envia cookies do servidor para o agente de usuário.
Cookie2
Used to contain an HTTP cookie, previously sent by the server with the Set-Cookie2 header, but has been obsoleted by the specification. Use Cookie instead.
Set-Cookie2
Used to send cookies from the server to the user agent, but has been obsoleted by the specification. Use Set-Cookie instead.

CORS

Access-Control-Allow-Origin

Indica se a resposta pode ser compartilhada.
Access-Control-Allow-Credentials
Indica se a resposta a requisição pode ou não ser exposta quando a flag de crendenciais é verdadeira.
Access-Control-Allow-Headers
Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request.
Access-Control-Allow-Methods
Specifies the method or methods allowed when accessing the resource in response to a preflight request.
Access-Control-Expose-Headers
Indicates which headers can be exposed as part of the response by listing their names.
Access-Control-Max-Age
Indicates how long the results of a preflight request can be cached.
Access-Control-Request-Headers
Used when issuing a preflight request to let the server know which HTTP headers will be used when the actual request is made.
Access-Control-Request-Method
Used when issuing a preflight request to let the server know which HTTP method will be used when the actual request is made.
Origin
Indicates where a fetch originates from.

Do Not Track

DNT
Usado para expressas a preferência de rastreamento do usuário 
Tk
Indica o status de rastreamento aplicado  à requisição correspondente.

Downloads

Content-Disposition
Is a response header if the ressource transmitted should be displayed inline (default behavior when the header is not present), or it should be handled like a download and the browser should present a 'Save As' window.

Informações do corpo da mensagem

Content-Length
indicates the size of the entity-body, in decimal number of octets, sent to the recipient.
Content-Type
Indica o tipo de mídia do recurso.
Content-Encoding
Usado para especificar o algoritmo de compressão.
Content-Language
Describes the language(s) intended for the audience, so that it allows a user to differentiate according to the users' own preferred language.
Content-Location
Indica um local alternativo para os dados retornados.

Roteamento de mensagens

Via
Added by proxies, both forward and reverse proxies, and can appear in the request headers and the response headers.

Redirecionamentos

Location
Indicates the URL to redirect a page to.

Contexto da requisição

From
Contains an Internet email address for a human user who controls the requesting user agent.
Host
Specifies the domain name of the server (for virtual hosting), and (optionally) the TCP port number on which the server is listening.
Referer
The address of the previous web page from which a link to the currently requested page was followed.
Referrer-Policy
Governs which referrer information sent in the Referer header should be included with requests made.
User-Agent
Contains a characteristic string that allows the network protocol peers to identify the application type, operating system, software vendor or software version of the requesting software user agent. See also the Firefox user agent string reference.

Contexto da resposta

Allow
...
Server
Contém informações a respeito do programa utilizado pelo servidor de origem para lidar com a requisição.

Requisições Range

Accept-Ranges
Indicates if the server supports range requests and, if so, in which unit the range can be expressed.
Range
...
If-Range
Create a conditional range request that is only fulfilled if the etag or date given in parameter match the remote resource. Used to prevent downloading two ranges from incompatible version of the resource.
Content-Range
...

Segurança

Content-Security-Policy (CSP)
Controls resources the user agent is allowed to load for a given page.
Content-Security-Policy-Report-Only
Allows web developers to experiment with policies by monitoring (but not enforcing) their effects. These violation reports consist of JSON documents sent via an HTTP POST request to the specified URI.
Public-Key-Pins (HPKP)
Associates a specific cryptographic public key with a certain web server to decrease the risk of MITM attacks with forged certificates.
Public-Key-Pins-Report-Only
Sends reports to the report-uri specified in the header and does still allow clients to connect to the server even if the pinning is violated.
Strict-Transport-Security (HSTS)
Force communication using HTTPS instead of HTTP.
Upgrade-Insecure-Requests
Sends a signal to the server expressing the client’s preference for an encrypted and authenticated response, and that it can successfully handle the upgrade-insecure-requests directive.
X-Content-Type-Options
Disables MIME sniffing and forces browser to use the type given in Content-Type.
X-Frame-Options (XFO)
Indicates whether or not a browser should be allowed to render a page in a <frame>, <iframe> or <object>
X-XSS-Protection
Enables cross-site scripting filtering.

Server-sent events

Ping-From
...
Ping-To
...
Last-Event-ID
...

Transfer coding

Transfer-Encoding
Specifies the the form of encoding used to safely transfer the entity to the user.
TE
Specifies the transfer encodings the user agent is willing to accept.
Trailer
Allows the sender to include additional fields at the end of chunked message.

WebSockets

Sec-WebSocket-Key
...
Sec-WebSocket-Extensions
...
Sec-WebSocket-Accept
...
Sec-WebSocket-Protocol
...
Sec-WebSocket-Version
...

Outros

Date
Contém a data e hora em que a mensagem foi produzida.
Link
...
Retry-After
Indica quanto tempo o User-Agent deve esperar antes de realizar uma requisição de acompanhamento.
Upgrade
This is a Proposed Internet Standard. To view a comprehensive list of all Official and Proposed Internet Standards with detailed information about each, visit this Internet Standards reference, which is updated daily.  The relevant RFC document for the Upgrade header field standard is RFC 7230, section 6.7.  The standard establishes rules for upgrading or changing to a different protocol on the current client, server, transport protocol connection.  For example, this header standard allows a client to change from HTTP 1.1 to HTTP 2.0, assuming the server decides to acknowledge and implement the Upgrade header field.  Niether party is required to accept the terms specified in the Upgrade header field.  It can be used in both client and server headers.  If the Upgrade header field is specified, then the sender MUST also send the Connection header field with the upgrade option specified.  For details on the Connection header field please see section 6.1 of the aforementioned RFC.
Vary
Determines how to match future request headers to decide whether a cached response can be used rather than requesting a fresh one from the origin server.
X-Content-Duration
...
X-DNS-Prefetch-Control
Controls DNS prefetching, a feature by which browsers proactively perform domain name resolution on both links that the user may choose to follow as well as URLs for items referenced by the document, including images, CSS, JavaScript, and so forth.
X-Requested-With
...
X-UA-Compatible
...

Veja também

Tópicos relacionados
  1. HTTP
  2. Guides:
  3. Resources and URIs
    1. Identifying resources on the Web
    2. Data URIs
    3. Introduction to MIME Types
    4. Complete list of MIME Types
    5. Choosing between www and non-www URLs
  4. HTTP guide
    1. Basics of HTTP
    2. Overview of HTTP
    3. Evolution of HTTP
    4. HTTP Messages
    5. A typical HTTP session
    6. Connection management in HTTP/1.x
    7. Protocol upgrade mechanism
  5. HTTP security
    1. Content Security Policy (CSP)
    2. HTTP Public Key Pinning (HPKP)
    3. HTTP Strict Transport Security (HSTS)
    4. Cookie security
    5. X-Content-Type-Options
    6. X-Frame-Options
    7. X-XSS-Protection
    8. Mozilla web security guidelines
    9. Mozilla Observatory
  6. HTTP access control (CORS)
  7. HTTP authentication
  8. HTTP caching
  9. HTTP compression
  10. HTTP conditional requests
  11. HTTP content negotiation
  12. HTTP cookies
  13. HTTP range requests
  14. HTTP redirects
  15. HTTP specifications
  16. Feature policy
  17. References:
  18. HTTP headers
    1. Accept
    2. Accept-CH
    3. Accept-CH-Lifetime
    4. Accept-Charset
    5. Accept-Encoding
    6. Accept-Language
    7. Accept-Patch
    8. Accept-Ranges
    9. Access-Control-Allow-Credentials
    10. Access-Control-Allow-Headers
    11. Access-Control-Allow-Methods
    12. Access-Control-Allow-Origin
    13. Access-Control-Expose-Headers
    14. Access-Control-Max-Age
    15. Access-Control-Request-Headers
    16. Access-Control-Request-Method
    17. Age
    18. Allow
    19. Alt-Svc
    20. Authorization
    21. Cache-Control
    22. Clear-Site-Data
    23. Connection
    24. Content-Disposition
    25. Content-Encoding
    26. Content-Language
    27. Content-Length
    28. Content-Location
    29. Content-Range [Traduzir]
    30. Content-Security-Policy [Traduzir]
    31. Content-Security-Policy-Report-Only [Traduzir]
    32. Content-Type
    33. Cookie [Traduzir]
    34. Cookie2 [Traduzir]
    35. Cross-Origin-Resource-Policy [Traduzir]
    36. DNT [Traduzir]
    37. DPR [Traduzir]
    38. Date [Traduzir]
    39. Device-Memory [Traduzir]
    40. Digest [Traduzir]
    41. ETag [Traduzir]
    42. Early-Data [Traduzir]
    43. Expect [Traduzir]
    44. Expect-CT [Traduzir]
    45. Expires
    46. Feature-Policy [Traduzir]
    47. Forwarded [Traduzir]
    48. From [Traduzir]
    49. Host
    50. If-Match [Traduzir]
    51. If-Modified-Since
    52. If-None-Match [Traduzir]
    53. If-Range [Traduzir]
    54. If-Unmodified-Since
    55. Index [Traduzir]
    56. Keep-Alive
    57. Large-Allocation [Traduzir]
    58. Last-Modified
    59. Link [Traduzir]
    60. Location
    61. Origin [Traduzir]
    62. Pragma [Traduzir]
    63. Proxy-Authenticate [Traduzir]
    64. Proxy-Authorization [Traduzir]
    65. Public-Key-Pins [Traduzir]
    66. Public-Key-Pins-Report-Only [Traduzir]
    67. Range [Traduzir]
    68. Referer
    69. Referrer-Policy [Traduzir]
    70. Retry-After
    71. Save-Data [Traduzir]
    72. Sec-Fetch-Dest [Traduzir]
    73. Sec-Fetch-Mode [Traduzir]
    74. Sec-Fetch-Site [Traduzir]
    75. Sec-Fetch-User [Traduzir]
    76. Sec-WebSocket-Accept [Traduzir]
    77. Server
    78. Server-Timing [Traduzir]
    79. Set-Cookie
    80. Set-Cookie2 [Traduzir]
    81. SourceMap
    82. Strict-Transport-Security
    83. TE [Traduzir]
    84. Timing-Allow-Origin [Traduzir]
    85. Tk [Traduzir]
    86. Trailer [Traduzir]
    87. Transfer-Encoding [Traduzir]
    88. Upgrade-Insecure-Requests
    89. User-Agent
    90. Vary [Traduzir]
    91. Via [Traduzir]
    92. WWW-Authenticate
    93. Want-Digest [Traduzir]
    94. Warning [Traduzir]
    95. X-Content-Type-Options
    96. X-DNS-Prefetch-Control
    97. X-Forwarded-For [Traduzir]
    98. X-Forwarded-Host [Traduzir]
    99. X-Forwarded-Proto [Traduzir]
    100. X-Frame-Options [Traduzir]
    101. X-XSS-Protection [Traduzir]
  19. HTTP request methods
    1. CONNECT
    2. DELETE
    3. GET
    4. HEAD
    5. OPTIONS
    6. PATCH
    7. POST
    8. PUT
    9. TRACE
  20. HTTP response status codes
    1. 100 Continue
    2. 101 Switching Protocols
    3. 103 Early Hints
    4. 200 OK
    5. 201 Created
    6. 202 Accepted
    7. 203 Non-Authoritative Information
    8. 204 No Content
    9. 205 Reset Content
    10. 206 Partial Content
    11. 300 Multiple Choices
    12. 301 Moved Permanently
    13. 302 Found
    14. 303 See Other
    15. 304 Not Modified
    16. 307 Redirecionamento temporário
    17. 308 Permanent Redirect
    18. 400 Bad Request
    19. 401 Unauthorized
    20. 402 Payment Required
    21. 403 Forbidden
    22. 404 Not Found
    23. 405 Method Not Allowed
    24. 406 Not Acceptable
    25. 407 Proxy Authentication Required
    26. 408 Request Timeout
    27. 409 Conflict
    28. 410 Gone
    29. 411 Length Required
    30. 412 Precondition Failed
    31. 413 Payload Too Large
    32. 414 URI Too Long
    33. 415 Unsupported Media Type
    34. 416 Range Not Satisfiable
    35. 417 Expectation Failed
    36. 418 I'm a teapot
    37. 422 Unprocessable Entity
    38. 425 Too Early
    39. 426 Upgrade Required
    40. 428 Precondition Required
    41. 429 Too Many Requests
    42. 431 Request Header Fields Too Large
    43. 451 Unavailable For Legal Reasons
    44. 500 Internal Server Error
    45. 501 Not Implemented
    46. 502 Bad Gateway
    47. 503 Service Unavailable
    48. 504 Gateway Timeout
    49. 505 HTTP Version Not Supported
    50. 506 Variant Also Negotiates
    51. 507 Insufficient Storage
    52. 508 Loop Detected
    53. 510 Not Extended
    54. 511 Network Authentication Required
  21. CSP directives
    1. CSP: base-uri [Traduzir]
    2. CSP: block-all-mixed-content [Traduzir]
    3. CSP: child-src [Traduzir]
    4. CSP: connect-src [Traduzir]
    5. CSP: default-src [Traduzir]
    6. CSP: font-src [Traduzir]
    7. CSP: form-action [Traduzir]
    8. CSP: frame-ancestors [Traduzir]
    9. CSP: frame-src [Traduzir]
    10. CSP: img-src [Traduzir]
    11. CSP: manifest-src [Traduzir]
    12. CSP: media-src [Traduzir]
    13. CSP: navigate-to [Traduzir]
    14. CSP: object-src [Traduzir]
    15. CSP: plugin-types [Traduzir]
    16. CSP: prefetch-src [Traduzir]
    17. CSP: referrer [Traduzir]
    18. CSP: report-to [Traduzir]
    19. CSP: report-uri [Traduzir]
    20. CSP: require-sri-for [Traduzir]
    21. CSP: sandbox [Traduzir]
    22. CSP: script-src [Traduzir]
    23. CSP: script-src-attr [Traduzir]
    24. CSP: script-src-elem [Traduzir]
    25. CSP: style-src [Traduzir]
    26. CSP: style-src-attr [Traduzir]
    27. CSP: style-src-elem [Traduzir]
    28. CSP: trusted-types [Traduzir]
    29. CSP: upgrade-insecure-requests [Traduzir]
    30. CSP: worker-src [Traduzir]
  22. CORS errors
    1. Reason: CORS disabled [Traduzir]
    2. Reason: CORS header 'Access-Control-Allow-Origin' does not match 'xyz' [Traduzir]
    3. Reason: CORS header 'Access-Control-Allow-Origin' missing
    4. Reason: CORS header ‘Origin’ cannot be added [Traduzir]
    5. Reason: CORS preflight channel did not succeed [Traduzir]
    6. Razão: A requisição CORS não foi bem sucedida
    7. Reason: CORS request external redirect not allowed [Traduzir]
    8. Reason: CORS request not HTTP
    9. Reason: Credential is not supported if the CORS header ‘Access-Control-Allow-Origin’ is ‘*’ [Traduzir]
    10. Reason: Did not find method in CORS header ‘Access-Control-Allow-Methods’ [Traduzir]
    11. Reason: Multiple CORS header 'Access-Control-Allow-Origin' not allowed [Traduzir]
    12. Reason: expected ‘true’ in CORS header ‘Access-Control-Allow-Credentials’ [Traduzir]
    13. Reason: invalid token ‘xyz’ in CORS header ‘Access-Control-Allow-Headers’ [Traduzir]
    14. Reason: invalid token ‘xyz’ in CORS header ‘Access-Control-Allow-Methods’ [Traduzir]
    15. Reason: missing token ‘xyz’ in CORS header ‘Access-Control-Allow-Headers’ from CORS preflight channel [Traduzir]
  23. Feature-Policy directives
    1. Feature-Policy: accelerometer [Traduzir]
    2. Feature-Policy: ambient-light-sensor [Traduzir]
    3. Feature-Policy: autoplay [Traduzir]
    4. Feature-Policy: battery [Traduzir]
    5. Feature-Policy: camera [Traduzir]
    6. Feature-Policy: display-capture [Traduzir]
    7. Feature-Policy: document-domain [Traduzir]
    8. Feature-Policy: encrypted-media [Traduzir]
    9. Feature-Policy: fullscreen [Traduzir]
    10. Feature-Policy: geolocation [Traduzir]
    11. Feature-Policy: gyroscope [Traduzir]
    12. Feature-Policy: layout-animations [Traduzir]
    13. Feature-Policy: legacy-image-formats [Traduzir]
    14. Feature-Policy: magnetometer [Traduzir]
    15. Feature-Policy: microphone [Traduzir]
    16. Feature-Policy: midi [Traduzir]
    17. Feature-Policy: oversized-images [Traduzir]
    18. Feature-Policy: payment [Traduzir]
    19. Feature-Policy: picture-in-picture [Traduzir]
    20. Feature-Policy: publickey-credentials [Traduzir]
    21. Feature-Policy: sync-xhr [Traduzir]
    22. Feature-Policy: unoptimized-images [Traduzir]
    23. Feature-Policy: unsized-media [Traduzir]
    24. Feature-Policy: usb [Traduzir]
    25. Feature-Policy: vibrate [Traduzir]
    26. Feature-Policy: vr [Traduzir]
    27. Feature-Policy: wake-lock [Traduzir]
    28. Feature-Policy: xr [Traduzir]
    29. Feature-Policy: xr-spatial-tracking [Traduzir]