Como funcionam as URLs: estrutura, codificação, parâmetros e fragmentos
Cada link em que você clica é um pequeno manual de instruções. Aprenda a ler cada parte de uma URL: esquema, host, porta, caminho, consulta, fragmento, e como a codificação percentual protege os caracteres especiais.
O que você vai aprender
- Ler qualquer URL parte por parte e dizer o que cada pedaço faz
- Saber quais caracteres precisam ser codificados percentualmente — e por quê
- Distinguir uma query string de um fragmento, e saber qual delas o servidor vê
- Identificar a diferença entre encodeURI e encodeURIComponent
- Evitar o bug de codificação dupla que quebra links e APIs
- Anatomia de uma URL
- Esquema, host e porta
- Caminho, query string e fragmento
- Codificação percentual: por que %20 significa um espaço
- URLs relativas vs absolutas
- Erros comuns
- Experimente: URL Encoder
- Perguntas frequentes
Anatomia de uma URL
Uma URL é um endereço com uma gramática fixa. Desmonte esta:
https://user:pass@example.com:8080/path/to/page?query=1&x=2#section └─┬──┘ └────┬────┘ └────┬────┘ └┬┘ └─────┬─────┘ └────┬────┘ └──┬───┘ scheme userinfo host port path query fragment
| Parte | O que faz |
|---|---|
scheme | Como conectar: https, http, ftp, mailto. https significa HTTP com criptografia TLS. |
userinfo | Opcional user:password@ credenciais. Raro na web hoje — e um truque clássico de phishing, porque https://google.com@evil.com na verdade vai para evil.com. |
host | O nome de domínio (resolvido pelo DNS) ou um endereço IP. Não diferencia maiúsculas de minúsculas. |
port | Opcional. Os padrões são 443 para HTTPS e 80 para HTTP — os navegadores os ocultam quando são o padrão. |
path | Qual recurso no servidor. Diferencia maiúsculas de minúsculas na maioria dos servidores: /Page e /page podem ser páginas diferentes. |
query | Dados chave-valor depois de ?, unidos por &. Termos de busca, filtros e códigos de rastreamento ficam aqui. |
fragment | Depois de #: uma posição dentro da página. Tratada apenas pelo navegador — nunca é enviada ao servidor. |
Esquema, host e porta
O esquema define as regras. https:// criptografa a conexão; http:// não, e tudo o que você envia pode ser lido na rede. Os navegadores modernos alertam sobre HTTP simples em páginas de login e pagamento exatamente por isso.
O host é um nome de domínio, e o DNS o transforma em um endereço IP antes de qualquer conexão — essa etapa é abordada no nosso guia de DNS. As portas são o endereço mais específico: um servidor pode executar muitos serviços em um IP, um por porta. O tráfego web usa 80/443 por convenção, e é por isso que você quase nunca vê uma porta em um link.
Caminho, query string e fragmento
O caminho é a parte pela qual os servidores roteiam: /guides/what-is-dns significa “a seção de guias, a página de DNS”. Uma barra final importa mais do que parece — /guides e /guides/ podem ser recursos diferentes, e os servidores geralmente redirecionam um para o outro.
O string de consulta são dados, não um endereço: ?q=shoes&sort=price pede ao servidor sapatos ordenados por preço. A ordem dos parâmetros geralmente não importa, mas chaves duplicadas (?tag=a&tag=b) ocorrem, e os servidores as tratam de formas diferentes — alguns pegam a primeira, outros a última, outros as tratam como uma lista.
O fragmento (#section) nunca sai do seu navegador. Ele rola até uma âncora ou controla a visualização de um aplicativo de página única. Duas consequências: fragmentos não afetam o que o servidor retorna, e não aparecem nos logs do servidor — e é por isso que “links de compartilhamento” que carregam estado no fragmento podem ser ao mesmo tempo privados e confusos.
Codificação percentual: por que %20 significa um espaço
As URLs só podem conter um conjunto limitado de caracteres. Todo o resto — espaços, letras de outros idiomas, &, =, ? dentro de um valor — precisa ser codificado percentualmente: substituído por % mais dois dígitos hexadecimais do valor do byte. Um espaço é o byte 0x20, então ele se torna %20.
| Caractere | Codificado | Por quê |
|---|---|---|
| espaço | %20 | Não permitido em uma URL |
& | %26 | Dividiria os parâmetros de consulta |
= | %3D | Dividiria uma chave de seu valor |
? | %3F | Iniciaria uma nova query string |
# | %23 | Iniciaria um fragmento |
% | %25 | O próprio caractere de escape |
| é / 中 | %C3%A9 / %E4%B8%AD | Bytes UTF-8, cada um codificado percentualmente |
Em JavaScript, há dois codificadores e eles não são intercambiáveis: encodeURI() codifica uma URL inteira, mas deixa : / ? & = # sozinhos (eles são estruturais); encodeURIComponent() codifica um único valor e escapa esses também. Codificar uma URL inteira com encodeURIComponent a destrói; codificar um valor com encodeURI deixa um & dentro dele que divide seu parâmetro em dois.
+ armadilha. Em strings de consulta, + tradicionalmente significa um espaço (dos formulários HTML), mas em um caminho + é um sinal de mais literal. Se o seu código decodifica + como um espaço em qualquer lugar, um nome de arquivo como C++ vira C . Decodifique + como um espaço somente em strings de consulta.URLs relativas vs absolutas
Um absoluta URL traz tudo (https://veryusefultools.com/guides/). Uma relativa URL pega emprestadas as partes que faltam da página atual: what-is-dns.html (na mesma pasta), ../index.html (uma pasta acima), /guides/ (a partir da raiz do site). Links relativos mantêm um site portátil — mude o site inteiro para um novo domínio e todos os links internos continuam funcionando. Links absolutos são os que você compartilha com outras pessoas.
Erros comuns
- Codificação dupla. Codificar um valor já codificado transforma
%20em%2520(o%em si é codificado). O servidor então decodifica uma vez e ainda vê%20como texto literal. Codifique exatamente uma vez, o mais tarde possível. - Codificar a URL inteira com encodeURIComponent. O
://e/são escapados e o link morre. - Colocar segredos na query string. URLs são registradas por servidores, proxies e ferramentas de análise, e compartilhadas em capturas de tela. Tokens e senhas pertencem a cabeçalhos ou corpos POST, nunca a um link.
- Supor que o caminho não diferencia maiúsculas de minúsculas. O host não diferencia; o caminho geralmente diferencia.
- Confiar no texto antes do @.
https://paypal.com@evil.comvai paraevil.com. Leia o host — a parte depois do último@e antes do próximo/.
Experimente: URL Encoder
Cole uma URL bagunçada no URL Encoder e veja cada caractere ser codificado — depois decodifique de volta. É a maneira mais rápida de ver a codificação percentual funcionando nos seus próprios links.
Continue aprendendo
Perguntas frequentes
Qual é a diferença entre uma URL, uma URI e uma URN?
Uma URI é o conceito geral: qualquer identificador de um recurso. Uma URL é uma URI que também diz como chegar até ele (uma localização). Uma URN é uma URI que nomeia algo sem dizer onde está, como urn:isbn:9780134685991. Toda URL é uma URI, mas nem toda URI é uma URL.
Qual pode ser o tamanho de uma URL?
O padrão não define limite, mas os navegadores definem — cerca de 2,000 caracteres no Internet Explorer antigo, em torno de 8,000+ no Chrome moderno. URLs longas também quebram em e-mails e chats. Se sua query string estiver passando de algumas centenas de caracteres, envie os dados como corpo POST.
Uma URL pode conter chinês, árabe ou emoji?
Sim — os navegadores os exibem, mas por baixo são bytes UTF-8 codificados percentualmente (e nomes de domínio usam punycode, por exemplo, xn--fiqs8s para 中国). Copie um link com caracteres de outros idiomas e você verá a forma codificada na área de transferência.
Por que alguns links mostram %20 e outros mostram + para espaços?
Ambos significam “espaço” em uma query string, de tradições diferentes: %20 é codificação percentual, + vem da codificação de formulários HTML. No caminho, somente %20 está correto — um + ali é um sinal de mais literal.
O fragmento (#…) é enviado ao servidor?
Não. O navegador o remove antes de fazer a requisição. É por isso que aplicativos de página única podem armazenar o estado da visualização no fragmento sem que o servidor jamais o veja — e por isso um link compartilhado com um fragmento às vezes não reproduz o que o remetente viu.