Como analisar e interpretar parâmetros de URL
Decomponha qualquer URL em protocolo, host, caminho e query; ajuste valores individuais para testes de API; decodifique percent-encoding em um passo.
Mais utilitários que combinam com este guia:
Por que isso importa
Um QA depura um checkout. Marketing cola URLs com UTMs, mas o ambiente de teste rejeita algumas requisições. O vilão oculto: um & dentro do valor content da UTM sem codificar, quebrando o parser da query. Um inspetor que lista cada par chave-valor em sua própria linha — e permite editar — expõe o bug em segundos.
Três cenários reais
Cole a URL da requisição; ache o & não codificado no valor.
Parâmetro ruim encontrado
Decomponha a URL e verifique utm_source / medium / campaign / content / term presentes e bem formados.
Atribuição limpa
Monte a URL aos poucos; valores escapados automaticamente; copie o resultado final.
Chamada API num único round-trip
Passo a passo
Abra o analisador de URL.
Cole a URL
Qualquer URL compatível — http, https, ws, ftp, esquemas customizados. A ferramenta decompõe ao colar.
Inspecione as partes
Protocolo, usuário/senha (se houver), host, porta, caminho, hash e query completa.
Veja parâmetros em tabela
Cada par na própria linha com valores brutos e decodificados. Encoding inconsistente salta aos olhos.
Edite um valor
Altere um parâmetro; a ferramenta re-codifica e reconstrói a URL corretamente.
Copie a URL reconstruída
Ou copie só um valor decodificado para usar no código.
URL
https://shop.example.com/cart/checkout?
cart_id=A1%26B2&
utm_source=newsletter%2520Q1&
ref=abc%20123Decomposição
Protocol: https
Host: shop.example.com
Path: /cart/checkout
Params:
cart_id → "A1&B2"
utm_source → "newsletter%20Q1" ← codificado duas vezes!
ref → "abc 123"
Dicas avançadas
- Decodifique cada valor separadamente.
decodeURIComponentna URL inteira muda o significado de=e&. O parser trata cada valor — é o correto. - Cuidado com dupla codificação.
%2520é%20codificado duas vezes (espaço →%20→%2520). O valor decodificado não deve carregar outro%. - Use a URL reconstruída ao repassar para QA reproduzir bug — normaliza espaços e escapes.
- Inspecione o fragmento
#em SPAs. Alguns apps guardam estado no#em vez da query.
Armadilhas comuns
Erro comum
Espaços viram "+" em vez de "%20"
URLs codificadas como formulário HTML usam + para espaços; URI-encoded usa %20. Ambos decodificam igual na query, mas APIs sem form-encoding podem rejeitar +.
Erro comum
Segmentos de caminho perdidos
Um ? no caminho sem encoder inicia a query cedo demais. Codifique ? como %3F quando deve permanecer no path.
Erro comum
Barra em valor de parâmetro
Alguns roteadores tratam / no valor como separador de path. Codifique %2F se o destino for sensível.
Quando esta não é a ferramenta certa
- Análise massiva de URLs — use
jq/awkou parser dedicado comoURLdo Node. - Crawling/scraping — script com rate limit adequado.
- Fluxos OAuth — use biblioteca; montagem manual é arriscada para segurança.
FAQ
Suporta hosts IPv6 na URL?
Sim. [2001:db8::1]:8080/path?x=1 funciona.
Posso analisar URL relativa?
Informe uma base; a ferramenta resolve relativos contra ela.
Minhas URLs são enviadas a algum lugar?
Não. O parsing é local via API URL do navegador.
Próximos passos
- Veja IP e ASN do host com consulta IP.
- Confira códigos de status em status HTTP.
- Codifique valores binários com codec Base64/Hex.