Publicado em
Em desenvolvimento web, SEO técnico, APIs e documentação, URI e URL aparecem o tempo todo. E, na prática, é bem comum ver os dois termos sendo usados como se fossem exatamente a mesma coisa.
A confusão faz sentido: toda URL é uma URI, mas nem toda URI é uma URL. Parece detalhe acadêmico, mas entender essa diferença ajuda a ler documentação técnica com mais segurança, estruturar endpoints, interpretar padrões da web e escrever com mais precisão.
URI significa Uniform Resource Identifier, ou identificador uniforme de recurso. Em termos simples, uma URI é uma forma padronizada de identificar um recurso.
Esse recurso pode ser uma página, uma imagem, um arquivo, um endpoint de API, um livro, um identificador interno ou qualquer outra coisa que precise ser nomeada de forma única dentro de um contexto.
O ponto principal é este: uma URI identifica um recurso, mas não precisa necessariamente dizer onde ele está localizado ou como acessá-lo.
URL significa Uniform Resource Locator, ou localizador uniforme de recurso. Ela é o tipo de endereço mais comum na web, usado para indicar onde um recurso está e como ele pode ser acessado.
Uma URL normalmente inclui informações como protocolo, domínio, caminho e, em alguns casos, parâmetros de consulta e fragmentos.
Por exemplo: https://example.com/blog/uri-e-url?utm_source=google#exemplos.
Nesse caso, a URL mostra que o recurso pode ser acessado via HTTPS, dentro do domínio example.com, no caminho /blog/uri-e-url, com parâmetros e um fragmento específico da página.
A diferença central é que URI é um conceito mais amplo, enquanto URL é um tipo específico de URI.
Uma URI serve para identificar um recurso. Uma URL, além de identificar, também informa a localização desse recurso e o meio de acesso.
Logo, dá para resumir assim:
Por isso, tecnicamente, toda URL é uma URI. Mas uma URI pode existir sem ser uma URL.
Uma URL aponta para onde o recurso está. Ela costuma responder à pergunta: “como eu acesso isso?”.
Quando você vê um endereço como https://site.com/produtos/camiseta, ele não apenas identifica a página de uma camiseta, mas também informa o protocolo, o domínio e o caminho para chegar até ela.
É por isso que, no dia a dia da web, quase sempre estamos lidando com URLs: links, páginas indexadas no Google, imagens, scripts, folhas de estilo, endpoints e arquivos públicos geralmente usam URLs.
Uma URI não precisa apontar para um endereço acessível no navegador. Ela pode funcionar apenas como um identificador.
Um exemplo clássico é uma URN, como urn:isbn:9780131103627. Ela identifica um livro pelo ISBN, mas não diz em qual site, servidor ou caminho esse livro pode ser acessado.
Essa é a parte que costuma dar nó na cabeça: uma URI pode parecer um “nome técnico” de algo, sem ser necessariamente um link clicável.
Para deixar a diferença mais concreta, vale olhar para exemplos simples. A URL é o caso mais familiar, porque aparece em navegadores, sitemaps, APIs e ferramentas diversas. Já uma URI que não é URL aparece mais em contextos de identificação, padrões, namespaces e especificações.
Um exemplo de URL seria: https://www.exemplo.com/artigos/seo-tecnico.
Esse endereço identifica uma página e também mostra onde ela está localizada. Ele informa que o recurso pode ser acessado pelo protocolo HTTPS, dentro do domínio www.exemplo.com, no caminho /artigos/seo-tecnico.
Outros exemplos de URL incluem:
https://example.com;https://example.com/imagens/logo.png;https://api.example.com/users/123;ftp://files.example.com/arquivo.zip.Todos esses exemplos indicam alguma forma de localização e acesso ao recurso.
Um exemplo de URI que não é URL seria: urn:isbn:9780131103627.
Esse identificador aponta para um livro específico por meio do ISBN, mas não informa onde comprar, baixar ou visualizar esse livro.
Outro exemplo comum em tecnologia é o uso de namespaces em XML: urn:example:products:category.
Esse tipo de identificador pode ser usado para nomear algo de forma única em um sistema, sem funcionar como endereço web acessível.
URI é o termo mais amplo. Dentro dele, existem formas diferentes de identificar recursos. As duas mais conhecidas são URL e URN.
A relação pode ser entendida assim:
Uma forma simples de visualizar é pensar que URI é a categoria geral. URL e URN são tipos mais específicos dentro dessa categoria.
No uso moderno, porém, URL é o termo mais presente no dia a dia. Quando alguém fala sobre endereço de página, link canônico, sitemap, rota de API ou imagem indexável, geralmente está falando de URL, mesmo que tecnicamente aquilo também seja uma URI.
Na maioria das conversas práticas sobre web, SEO e desenvolvimento, o termo URL é o mais adequado. Ele é mais específico e mais fácil de entender quando a intenção é falar de endereço acessível.
Use URL quando estiver falando de:
Use URI quando estiver falando de identificação em sentido mais amplo, especialmente em documentação técnica, especificações, namespaces, padrões ou quando o recurso não precisa ser acessível por um endereço.
Em código, também é comum encontrar o termo URI em nomes de variáveis, bibliotecas e APIs mesmo quando o valor usado é uma URL. Não é necessariamente um erro fatal, mas convém entender a diferença para não escrever documentação torta ou passar vergonha técnica de bobeira.
URI é um identificador de recurso. URL é um tipo de URI que, além de identificar, mostra onde o recurso está e como acessá-lo. Por isso, toda URL é uma URI, mas nem toda URI é uma URL.
No dia a dia, o termo URL resolve a maior parte dos casos envolvendo páginas, links, arquivos e endpoints. Já URI é mais útil quando o assunto é identificação em sentido amplo, especialmente em contextos mais técnicos.
Entender essa diferença não muda a vida de ninguém da noite para o dia, mas deixa sua leitura de documentação e comunicação técnica bem mais precisas.