O endereço que localiza um recurso
URL significa Uniform Resource Locator e identifica como localizar um recurso. Na web, pode apontar para uma página, imagem, arquivo ou operação de API. A URL reúne componentes com funções distintas, e nem todos precisam aparecer explicitamente.
Quando você copia um link de busca, ele pode incluir o site, o caminho da pesquisa e o termo consultado. Esses trechos não são apenas uma sequência de palavras. Os separadores permitem que o navegador identifique qual parte representa o destino e qual parte carrega parâmetros.
Considere https://example.com/catalogo?categoria=livros#resultados. O navegador acessa um recurso do catálogo com um parâmetro de categoria. O fragmento final pode indicar uma seção da página, caso exista um elemento correspondente.
As partes de uma URL HTTP
O esquema https indica o mecanismo de acesso. O host example.com identifica o servidor pelo nome, embora uma URL também possa usar um endereço IP. Uma porta explícita, como :8443, permite indicar um serviço diferente do padrão daquele esquema.
O caminho /catalogo identifica o recurso dentro desse endereço, sem exigir uma pasta física com esse nome no servidor. A aplicação pode receber esse caminho, consultar os produtos e produzir a página do catálogo a cada chamada.
A consulta começa depois de ? e costuma usar pares de nome e valor. O serviço determina se reconhece categoria=livros e como aplica esse parâmetro. Acrescentar um nome arbitrário à URL não cria um filtro automaticamente.
O fragmento começa depois de # e não é enviado ao servidor na requisição HTTP. Ele pode orientar o navegador ou o código da página. Por isso, colocar um filtro depois de # não equivale a enviá-lo como parâmetro de consulta.
Esquema: https
Host: example.com
Caminho: /catalogo
Consulta: categoria=livros
Fragmento: resultadosEndereço absoluto e referência relativa
Uma URL absoluta informa o destino completo. Uma referência como /glossario/api/ depende de uma URL base para formar o endereço final. Em uma página comum, ela aponta para esse caminho na mesma origem.
Já imagem.png, sem barra inicial, é resolvida em relação ao caminho da base. Essa diferença pode explicar uma imagem que funciona na página inicial e falha em uma página interna. O navegador pode estar procurando o arquivo em outro diretório.
Como montar e conferir um endereço
Valores com caracteres especiais precisam ser codificados conforme o componente da URL. Ao programar, use ferramentas como URL e URLSearchParams para montar a consulta. Concatenar texto manualmente pode transformar um & do valor em separador de outro parâmetro.
Evite incluir senhas ou tokens na consulta, pois URLs podem aparecer em histórico e registros de acesso. Na investigação, confira o endereço efetivamente enviado na aba Network e compare cada componente com o contrato. O verbete de origem web explica como esquema, host e porta participam do isolamento entre páginas.
Dúvidas frequentes
Perguntas frequentes sobre URL
- Domínio e URL são a mesma coisa?
- O domínio pode compor o host de uma URL. A URL também pode incluir esquema, porta, caminho, consulta e fragmento, além de aceitar um endereço IP como host.
- O fragmento depois de
- O fragmento não é enviado na requisição HTTP. Ele é interpretado pelo navegador ou pelo código da página, por exemplo para localizar uma seção.
- O caminho representa uma pasta física?
- A aplicação pode interpretar o caminho e gerar a resposta sem uma pasta correspondente. A organização da URL não revela necessariamente a estrutura de arquivos do servidor.
- Uma URL válida garante que a API aplicará o filtro?
- A sintaxe válida permite interpretar o endereço, mas o serviço precisa reconhecer os parâmetros. Confira seus nomes e valores na documentação da operação.
Para continuar
Recursos relacionados
Documentação
Anatomia de uma URL na MDN
Explica esquema, host, porta, caminho, consulta e fragmento.
Abrir recursoDocumentação
Semântica HTTP na RFC 9110
Especifica a comunicação HTTP e o significado de suas mensagens.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Conheça o acompanhamento técnico ao vivo para conferir host, caminho e parâmetros dos endereços utilizados na integração.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A URL identifica os destinos utilizados pela interface para buscar páginas e chamar serviços.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.