Analisador de URL

O Analisador de URL é uma ferramenta gratuita que separa um endereço da web em esquema, caminho e string de consulta.

O que um analisador de URL extrai?

Um analisador de URL identifica os componentes estruturais de um endereço da web sem que você precise dividir o texto manualmente. A ferramenta retorna três campos gerados pela função parse_url do PHP.

• Esquema identifica o protocolo ou esquema de endereçamento, como https ou http.
• Caminho identifica o componente de caminho, como /account/orders/42.
• Consulta contém o texto após o ponto de interrogação que inicia o componente de consulta e antes de qualquer cerquilha não codificada, como page=2&sort=date.

Analisar uma URL é útil ao examinar requisições de API, URLs de callback, logs de aplicações ou dados de terceiros. Assim, você consegue distinguir informações de roteamento dos parâmetros de consulta antes de depurar, registrar ou transformar o endereço.

Os campos retornados não incluem separadamente o nome do host, a porta ou o fragmento. Se precisar desses componentes, use uma biblioteca de análise de URL mais completa na sua aplicação.

Como usar o Analisador de URL?

Insira a URL completa ou parcial e confira os valores de esquema, caminho e consulta retornados pela ferramenta. Uma URL absoluta completa costuma produzir o resultado mais claro, pois informa explicitamente o esquema.

1. Copie a URL do navegador, da resposta da API, do registro do webhook ou do log do servidor.
2. Inclua a string de consulta se precisar examinar nomes ou valores de parâmetros.
3. Compare o caminho retornado com a rota esperada pela sua aplicação.
4. Verifique se o esquema e a consulta estão presentes onde sua integração exige esses componentes.

O processamento acontece no servidor. O conteúdo inserido é enviado ao servidor por HTTPS e não é armazenado. Mesmo assim, evite enviar tokens de acesso ativos, links de download assinados, identificadores de sessão ou outras credenciais quando um exemplo com dados ocultados for suficiente para responder à mesma dúvida.

Exemplos práticos e interpretação dos resultados

Em uma URL absoluta de API, o analisador separa o protocolo da rota e da string de consulta bruta.

Entrada https://api.example.co.uk/v1/orders/42?expand=items&currency=GBP

Esquema https

Caminho /v1/orders/42

Consulta expand=items&currency=GBP

A consulta é retornada como um único componente. Pela convenção comum de formulários e strings de consulta, o E comercial separa os campos, enquanto o primeiro sinal de igual de cada campo separa o nome do valor. A análise da URL, por si só, não confirma se expand ou currency é um parâmetro reconhecido pela API.

Uma referência relativa também pode conter caminho e consulta sem especificar um esquema.

Entrada /search?q=red%20shoes&page=2

Esquema no scheme component

Caminho /search

Consulta q=red%20shoes&page=2

A ausência de esquema costuma ser esperada em links gerados dentro de um mesmo site. Porém, em dados que deveriam conter URLs absolutas de callback, esse resultado pode indicar que o prefixo https:// está faltando.

Este analisador não é um validador de URL. Ele pode ajudar a identificar estruturas suspeitas, como um esquema ausente, um caminho inesperado ou texto de consulta no lugar errado. No entanto, um resultado analisado não comprova que o endereço existe, é resolvido no DNS ou retorna uma resposta HTTP bem-sucedida.

O que acontece com espaços, pontuação e entradas incomuns?

Os caracteres reservados afetam a divisão de uma URL, enquanto os caracteres codificados geralmente permanecem no componente em que aparecem. O analisador separa os componentes, mas não decodifica nem normaliza seu conteúdo.

• Um ponto de interrogação não codificado inicia o componente de consulta. Se um ponto de interrogação literal representar um dado fora de uma consulta existente, ele deverá ser codificado por porcentagem caso contrário funcione como delimitador da consulta.
• O E comercial normalmente separa parâmetros de consulta, mas esta ferramenta retorna a string de consulta completa em vez de interpretar cada parâmetro separadamente.
• Uma cerquilha não codificada (#) é o delimitador de fragmento na sintaxe padrão de URLs. Os dados do fragmento não estão entre os campos retornados aqui.
• Espaços normalmente devem ser codificados, em geral como %20. Um sinal de adição pode representar um espaço em dados de consulta codificados como formulário, mas essa interpretação pertence à decodificação da consulta, não à análise da URL.
• Textos com acentos ou caracteres não latinos no caminho ou na consulta devem usar codificação por porcentagem em UTF-8 quando exigido pelo sistema de destino. Nomes de domínio internacionalizados usam sua forma compatível com ASCII para garantir ampla compatibilidade entre protocolos.
• Números não têm nenhum comportamento especial durante a análise. Eles continuam sendo caracteres comuns dentro de um caminho ou valor de consulta.

Uma entrada vazia não oferece uma estrutura de URL útil para examinar. URLs muito longas também podem esbarrar em limites de outros sistemas, incluindo navegadores, servidores web, proxies e frameworks de aplicações. Esta ferramenta não determina se outro sistema aceitará uma URL com determinado comprimento.

Quando vale a pena analisar uma URL?

Vale a pena analisar uma URL quando você precisa entender a estrutura de um endereço antes que um código ou uma infraestrutura atue sobre ele. Casos comuns incluem verificar endereços de callback de webhooks antes da implantação, revisar destinos de redirecionamento, separar rotas de API dos filtros e ler URLs copiadas de logs de proxy reverso.

Em geral, isso é desnecessário quando apenas uma máquina consumirá uma URL conhecida e já estruturada, e sua aplicação já usa uma biblioteca de URL. Também não é a operação adequada se você precisa testar a disponibilidade, seguir redirecionamentos, decodificar todos os parâmetros de consulta ou verificar se um domínio é confiável.

Para tarefas repetitivas ou automatizadas, use os recursos de URL nativos do seu ambiente. O PHP tem parse_url, o JavaScript do navegador tem a interface URL, o Node.js oferece a classe URL e o Python inclui urllib.parse. Um pequeno script de linha de comando é mais adequado do que a análise manual ao processar um arquivo de log com milhares de endereços.

Não analise uma URL apenas para reformatá-la quando ela já tiver exatamente a representação exigida pelo sistema de destino. Recodificar ou reconstruir endereços sem um motivo claro pode alterar assinaturas de consulta, parâmetros duplicados ou caracteres reservados.

Perguntas frequentes

Posso analisar uma URL sem http ou https?

Sim. A função parse_url do PHP consegue interpretar referências relativas e URLs parciais, embora nenhum esquema esteja disponível quando ele não tiver sido informado. Tenha cuidado com endereços relativos ao esquema que começam com duas barras, pois o significado deles depende do documento ou da aplicação em que aparecem.

Os parâmetros de consulta repetidos são preservados?

A consulta é retornada como um componente bruto, portanto nomes repetidos podem permanecer na sequência original. A forma como valores como tag=red&tag=blue são convertidos em arrays ou valores individuais depende do analisador de string de consulta usado depois.

É seguro colar uma URL assinada?

A entrada é enviada por HTTPS e não é armazenada, mas uma URL assinada ainda pode conceder acesso a conteúdo privado enquanto a assinatura permanecer válida. Oculte o token ou substitua o nome do host e os valores por dados fictícios representativos sempre que as credenciais exatas não forem necessárias.

Por que uma URL que parece válida funciona de outro jeito na minha aplicação?

As diferenças podem surgir por causa da decodificação de consultas e da normalização Unicode específicas do framework. As aplicações também podem aplicar regras adicionais após a análise, incluindo listas de nomes de host permitidos e restrições de redirecionamento. Compare a URL bruta byte a byte e depois verifique o que sua aplicação decodifica ou reescreve antes de enviar a requisição.