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.

📂 Web e internet ⏱ Cerca de 9 minutos 📶 Iniciante 🛠️ Combina com: URL Encoder

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
Neste guia
  1. Anatomia de uma URL
  2. Esquema, host e porta
  3. Caminho, query string e fragmento
  4. Codificação percentual: por que %20 significa um espaço
  5. URLs relativas vs absolutas
  6. Erros comuns
  7. Experimente: URL Encoder
  8. 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
ParteO que faz
schemeComo conectar: https, http, ftp, mailto. https significa HTTP com criptografia TLS.
userinfoOpcional 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.
hostO nome de domínio (resolvido pelo DNS) ou um endereço IP. Não diferencia maiúsculas de minúsculas.
portOpcional. Os padrões são 443 para HTTPS e 80 para HTTP — os navegadores os ocultam quando são o padrão.
pathQual recurso no servidor. Diferencia maiúsculas de minúsculas na maioria dos servidores: /Page e /page podem ser páginas diferentes.
queryDados chave-valor depois de ?, unidos por &. Termos de busca, filtros e códigos de rastreamento ficam aqui.
fragmentDepois 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.

CaractereCodificadoPor quê
espaço%20Não permitido em uma URL
&%26Dividiria os parâmetros de consulta
=%3DDividiria uma chave de seu valor
?%3FIniciaria uma nova query string
#%23Iniciaria um fragmento
%%25O próprio caractere de escape
é / 中%C3%A9 / %E4%B8%ADBytes 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.

O + 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 %20 em %2520 (o % em si é codificado). O servidor então decodifica uma vez e ainda vê %20 como 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.com vai para evil.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.

Abrir o URL Encoder →

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.