URL

Definição

URL é a sigla de Uniform Resource Locator. É o identificador que informa como localizar um recurso por um esquema e seus componentes. A URL reúne esquema, host, porta quando explícita, caminho, consulta e fragmento.

https://exemplo.com/glossario?categoria=web#api
└─────┘ └────────┘ └────────┘ └────────────┘ └──┘
esquema    host     caminho      consulta   fragmento

Cada componente tem um papel

O esquema informa o mecanismo de acesso, o host indica onde o recurso está publicado e a porta, quando explícita, identifica o serviço no host. O caminho localiza o recurso, a consulta envia parâmetros e o fragmento aponta para uma parte do conteúdo.

Domínio é parte da URL

O domínio é apenas o componente host, não a URL inteira. Caminho e parâmetros não fazem parte do nome de domínio, e duas URLs podem compartilhar o mesmo domínio com origens e destinos diferentes.

O que pode falhar ao montar uma URL

A falha mais comum é colocar no caminho um valor que deveria estar na consulta, ou vice-versa. Quando o parâmetro de filtro vai para o caminho, a API recebe um endereço que não corresponde a nenhum recurso e responde com 404. Espaços e acentos sem codificação também quebram a chamada, porque o navegador precisa interpretar o texto antes de montar o destino. Para conferir, divida a URL em componentes e compare com o contrato da API. Se a consulta e o fragmento trocaram de posição ou um caractere ficou sem codificação, o destino não é o que você pretendia.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, a URL identifica o destino de cada chamada que a interface faz.

Conhecer a formação →