Codificador / decodificador de URL
Codifique texto para o formato URL seguro com codificação percentual ou decodifique URLs codificadas para texto legível. Também analisa URLs completas em esquema, host, caminho e parâmetros.
O que é codificação de URL?
Codificação de URL (percent-encoding) substitui caracteres inseguros em URLs por um sinal de porcentagem seguido de seu valor hexadecimal. Espaços viram %20, ampersands viram %26 e caracteres não-ASCII como texto em japonês recebem codificações multi-byte. Isso garante que as URLs sejam válidas e interpretáveis por navegadores e servidores. O analisador de URL abaixo do codificador quebra qualquer URL em seus componentes para fácil inspeção.
encodeURI vs encodeURIComponent
encodeURI() codifica uma URL completa, mas preserva os caracteres válidos na sintaxe (://?#&=). encodeURIComponent() codifica tudo exceto A-Z, a-z, 0-9 e alguns símbolos (-_.!~*'()). Use encodeURIComponent() para valores individuais de parâmetros e encodeURI() para URLs completas. Esta ferramenta suporta ambos os modos.
Análise de URL
O analisador abaixo do codificador divide qualquer URL em seus componentes: protocolo, host, porta, caminho, parâmetros de consulta e fragmento. Cada parâmetro é mostrado como par chave-valor. Útil para depurar endpoints de API, verificar URLs de redirecionamento e entender query strings complexas rapidamente.
Para codificação Base64, use nosso codificador / decodificador Base64.
Usos comuns
- Construção de string de consulta: Codifique termos de pesquisa, filtros ou entradas de formulário fornecidos pelo usuário antes de adicioná-los a uma URL para evitar injeção e requisições quebradas.
- Construção de URL de webhook e redirecionamento: Codifique o parâmetro de URL de retorno em fluxos OAuth e webhook para que sobreviva à transferência segura através de cadeias de redirecionamento de terceiros.
- Rastreamento de link em campanha de e-mail: Codifique parâmetros UTM e URLs de destino dentro de links de rastreamento para garantir que clientes de e-mail não os quebrem.
- Depuração de endpoint de API: Decodifique uma URL com codificação percentual de um log de servidor ou mensagem de erro para ler os parâmetros originais em formato legível por humanos.
- Criação de URL internacionalizada: Codifique caracteres não-ASCII (letras acentuadas, chinês, árabe, hindi) em URLs para uso em aplicativos web internacionais.
- Codificação de URL de caminho de arquivo: Codifique nomes de arquivo contendo espaços ou caracteres especiais para que funcionem corretamente como segmentos de caminho de URL.
- Compartilhamento de link em redes sociais: Codifique URLs antes de incorporá-las em meta tags de redes sociais para evitar que as plataformas removam ou interpretem mal os parâmetros.
FAQ
Por que espaços viram %20 nas URLs?
Espaço não é um caractere válido em URL — URLs são restritas a um subconjunto seguro de ASCII. %20 é a forma percent-encoded de espaço (0x20 em ASCII). Em envios de formulários HTML com application/x-www-form-urlencoded, espaços também podem aparecer como caracteres +, mas %20 é o padrão dentro de um caminho ou valor de consulta de URL.
Qual a diferença entre codificação de URL e Base64?
Codificação de URL torna o texto seguro para URL escapando caracteres especiais — é principalmente para compatibilidade com a sintaxe de URL. Base64 converte dados binários em texto ASCII, principalmente para transmitir binário através de canais somente-texto. São ferramentas diferentes para problemas diferentes, embora às vezes sejam combinadas (Base64 primeiro, depois URL-encode).
Preciso codificar a URL inteira ou apenas os parâmetros?
Geralmente só os parâmetros. Use o modo "Codificar componente" para valores individuais de consulta (o padrão). Use "Codificar URL completa" apenas quando estiver trabalhando com uma URL que contém caracteres não-ASCII no caminho ou no hostname e precisa escapá-los mantendo a estrutura da URL intacta.
O codificador de URL envia meus dados para algum lugar?
Não. Toda a codificação e decodificação é executada inteiramente no seu navegador. Suas URLs e dados de texto nunca saem do seu dispositivo.
Qual é a diferença entre encodeURI e encodeURIComponent?
encodeURI codifica uma URL completa e preserva caracteres como /, : e ? que têm significado estrutural em URLs. encodeURIComponent codifica um único valor e também substitui esses caracteres — use-o para valores individuais de query string.
Em números
- A RFC 3986 (2005) define os 18 caracteres reservados que devem ser codificados como porcentagem em URLs fora de seu papel sintático
- Para máxima compatibilidade com navegadores, URLs não devem exceder 2.048 caracteres na prática
- Todos os caracteres não-ASCII (pontos de código acima de 127) devem ser codificados em UTF-8 e depois codificados como porcentagem antes de aparecer em uma URL
- Nomes de domínio internacionalizados usam codificação Punycode — münchen.de torna-se xn--mnchen-3ya.de