O que é uma URL, afinal?
Toda URL é um endereço estruturado — aprenda a lê-lo
⏱ Estim. ~4 min
01 · Ler
Você passou a vida inteira clicando em URLs. Mas, como engenheiro, você precisa lê-las — não só clicar.
Toda URL é composta por partes diferentes, e cada parte tem um significado específico. Quando você consegue decompor uma URL, você consegue entender qualquer API, depurar qualquer requisição e construir qualquer funcionalidade de rede.
💡 Imagine assimUma URL é como um endereço postal. O protocol é o meio de transporte (aéreo vs terrestre), o host é o endereço da rua, o path é o número do apartamento, e a query string é um post-it colado no envelope com instruções extras.
Pontos-chave
- URLs são estruturadas — cada parte tem nome e propósito
- A query string (?key=value) é como você envia parâmetros opcionais
- Um path como /users/42 significa "recurso users, item 42"
- O mesmo host pode ter milhares de paths diferentes
02 · Exemplo de código
Vamos decompor uma URL real em suas partes.
URL completa
https://api.github.com/users/torvalds/repos?per_page=5&sort=updated
Protocol (protocolo)
https://
"How to talk" — encrypted HTTP connection.
Always https:// for real APIs (not http://).
Host (servidor)
api.github.com
"Who to talk to" — the server's address on the internet.
DNS translates this to an IP like 140.82.121.6.
Path (caminho)
/users/torvalds/repos
"What to ask for" — the specific resource on that server.
Like a file path, but for API resources.
Query string (string de consulta)
?per_page=5&sort=updated
"Extra options" — key=value pairs after the ?.
per_page=5 means "give me 5 results".
sort=updated means "sort by last updated".
O ? marca o início da query string. Cada parâmetro é key=value. Vários parâmetros são separados por &. O server lê cada um como uma opção ou um filtro.
03 · Classificar arrastando
Identifique a parte correta de cada trecho de URL abaixo.
(Esta seção é interativa — ative o JavaScript para usar.)
04 · Quiz
Na URL https://api.example.com/products?category=shoes&limit=20, o que limit=20 faz?
- Conecta na porta 20 do server
- Envia 'limit' como parâmetro de consulta com valor '20' — o server decide como tratar
- Limita o uso de CPU do server a 20%
- Define o tamanho máximo da URL em 20 caracteres
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.