files/pt-br/web/http/headers/alt-svc/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

---
title: Alt-Svc
slug: Web/HTTP/Headers/Alt-Svc
tags:
  - Cabeçalho HTTP
  - Cabeçalho de Resposta
  - HTTP
  - Reference
  - Referencia
translation_of: Web/HTTP/Headers/Alt-Svc
---
<p>O cabeçalho de resposta HTTP <strong><code style="white-space: nowrap;">Alt-Svc</code></strong> é usado para indicar que serviços alternativos que podem ser utilizados para alcançar o mesmo recurso. Um serviço alternativo é definido por uma combinação de protocolo/host/porta.</p>

<h2 id="Sintaxe">Sintaxe</h2>

<pre class="syntaxbox">Alt-Svc: clear
Alt-Svc: <var>&lt;protocol-id&gt;</var>=<em>&lt;alt-authority&gt;</em>; ma=<var>&lt;max-age&gt;</var>
Alt-Svc: <var>&lt;protocol-id&gt;</var>=<em>&lt;alt-authority&gt;</em>; ma=<var>&lt;max-age&gt;</var>; persist=1</pre>

<dl>
 <dt><code>clear</code></dt>
 <dd>O valor especial ''clear" indica que todas as requisições alternativas para aquela origem devem ser invalidadas.</dd>
 <dt><code>&lt;protocol-id&gt;</code></dt>
 <dd>O identificador de protocolo {{Glossary("ALPN")}}. Exemplos incluem o h2 para HTTP/2 e h3-25 como rascunho 25 para o protocolo HTTP/3.</dd>
 <dt><code>&lt;alt-authority&gt;</code></dt>
 <dd>A cadeia de caracteres entre aspas especificando a autoridade alternativa que consiste em uma sobrecarga de host opicional, dois pontos e um número de porta mandatório.</dd>
 <dt><code>ma=&lt;max-age&gt;</code>{{Optional_Inline}}</dt>
 <dd>O número de segundos que o serviço alternativo é considerado "fresco". Se omitido, seu padrão é 24 horas. Entradas de serviços alternativos podem ser cacheados até o limite de <em>&lt;max-age&gt;</em> segundos, menos a idade da resposta (do cabeçalho Age). Se a entrada cacheada expirar, o cliente não pode mais usar o serviço alternativo para novas conexões.</dd>
 <dt><code>persist=1</code>{{Optional_Inline}}</dt>
 <dd>Entradas cacheadas de serviços alternativos geralmente são limpas em mudanças nas configurações de rede. O uso do parâmetro persist=1 assegura que a entrada não será deletada para tais mudanças.</dd>
</dl>

<p>Múltiplas entradas podem ser especificadas em um único cabeçalho Alt-Svc usando vírgula como separador. Neste caso, as primeiras entradas são consideradas as mais preferíveis.</p>

<h2 id="Exemplos">Exemplos</h2>

<pre>Alt-Svc: h2=":443"; ma=2592000;
Alt-Svc: h2=":443"; ma=2592000; persist=1
Alt-Svc: h2="alt.example.com:443", h2=":443"
Alt-Svc: h3-25=":443"; ma=3600, h2=":443"; ma=3600</pre>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentários</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{RFC(7838)}}</td>
   <td><span class="spec-RFC">IETF RFC</span></td>
   <td>Definição inicial.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2>

<div class="hidden">The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a class="external external-icon" href="https://github.com/mdn/browser-compat-data" rel="noopener">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</div>

<p>{{Compat("http.headers.Alt-Svc")}}</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li><a href="/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web">Identificando recursos na Web</a></li>
</ul>