Como compor um URL a partir dos seus componentes

Conheça a finalidade da composição

O URL Builder permite compor um endereço a partir de componentes preenchidos separadamente. Pode escolher o esquema, indicar o anfitrião, acrescentar uma porta, definir o caminho e introduzir parâmetros, uma consulta ou um fragmento. Esta abordagem é útil quando pretende comparar composições, preparar um endereço para documentação ou perceber como diferentes valores aparecem juntos. A ferramenta também organiza o texto da consulta em informação estruturada de parâmetros, o que facilita a sua leitura antes de utilizar o endereço noutro contexto.

A composição deve ser entendida como o resultado dos valores fornecidos aos campos. Não corresponde a uma tentativa de abrir o destino nem a uma confirmação de que existe um serviço associado ao endereço. Assim, pode utilizar o resultado para rever a forma dos componentes, mas deve fazer uma verificação separada quando precisar de saber se um endereço responde ou se um serviço aceita determinados valores. A consulta estruturada ajuda a observar a divisão dos dados, sem transformar essa apresentação numa validação do conteúdo.

Siga a sequência de preenchimento

1. Selecione https ou http no campo do esquema. A opção inicial é https, portanto pode mantê-la quando esse for o esquema pretendido.

2. Reveja o anfitrião e substitua o valor inicial example.com pelo nome que quer incluir na composição. Se precisar de uma porta, introduza-a no campo próprio; o valor inicial é 0 e uma porta convertida para um número inteiro superior a zero aparece depois do anfitrião.

3. Preencha o caminho. O campo começa com /. Quando escrever um caminho sem a barra inicial, a ferramenta acrescenta / antes de o juntar aos restantes componentes, pelo que api passa a ser apresentado com essa separação.

4. Edite a consulta de acordo com a composição que quer observar. O valor inicial é key=value&lang=en. Os campos de parâmetros e fragmento começam vazios, mas podem ser preenchidos quando esses componentes fizerem parte do endereço que está a preparar.

5. Observe o resultado composto e a informação estruturada associada à consulta. Para comparar outra possibilidade, altere o componente relevante e reveja a nova apresentação, mantendo os restantes valores se quiser isolar essa mudança. Registe os elementos que pretende reutilizar, sem interpretar a composição como resposta de um destino.

Interprete o que é apresentado

Leia a apresentação final como uma sequência formada pelos valores introduzidos. Com os valores iniciais, o esquema é https, o anfitrião é example.com, o caminho é / e a consulta começa por key=value&lang=en, depois do separador próprio da consulta. Os campos de parâmetros e fragmento não acrescentam texto enquanto permanecerem vazios.

Se trocar o esquema, o anfitrião ou o caminho, esses elementos passam a reflectir as novas escolhas. Uma porta superior a zero fica junto do anfitrião, enquanto um caminho escrito sem separador inicial é mostrado com / acrescentado. Uma alteração na consulta pode ser acompanhada pela informação estruturada de parâmetros, permitindo observar como o texto fornecido foi separado para leitura.

Há limites importantes para esta interpretação. A composição não demonstra que os valores estejam codificados de uma forma específica, sejam válidos para um serviço, sejam aceites pelo destino ou mantenham a mesma forma depois de uma comunicação. O resultado serve para examinar a montagem, não para provar disponibilidade ou equivalência do endereço.

Exemplo prático

Precisa de preparar uma composição para um endereço de teste que use o esquema HTTP, o anfitrião test.com e o caminho api.

Selecione http, substitua example.com por test.com e escreva api no caminho. Em seguida, observe a composição e confirme que o caminho aparece com / antes de api. A consulta e os restantes campos podem permanecer nos valores que já apresentavam, se não fizerem parte desta preparação.

A apresentação contém o esquema http, o anfitrião test.com e o caminho /api na mesma composição, com a barra inicial visível no caminho; não é indicada uma resposta do destino.

Limitações

• A composição e a leitura dos parâmetros não confirmam codificação, validade, acessibilidade, aceitação por um serviço ou equivalência após uma comunicação.

Erros comuns

• Ao comparar api com a composição final, pode esquecer a barra acrescentada; escreva /api se quiser controlar visualmente o início ou confirme o separador mostrado no resultado.

Perguntas frequentes

A ferramenta acede ao site indicado?

Não. A ferramenta reúne os componentes e apresenta a consulta estruturada sem fazer um pedido de rede ao endereço indicado. Para saber se existe resposta, precisa de uma verificação separada adequada ao seu caso.

O que acontece se eu não escrever a barra no início do caminho?

Quando o caminho introduzido não começa por /, essa barra é acrescentada antes da composição. Por exemplo, api fica representado com a separação inicial, o que evita juntar o caminho directamente ao componente anterior.

A consulta é apresentada como parâmetros?

Sim. O texto fornecido na consulta é também organizado como informação estruturada de parâmetros. Essa organização permite examiná-lo, mas não confirma a codificação nem a aceitação dos valores por um serviço.