Codificar e decodificar URL: Entendendo a codificacao percentual para a web
Aprenda o que e codificacao URL (percentual), por que URLs precisam dela e como codificar e decodificar URLs para parametros e APIs.
1 de fevereiro de 2026
O que e codificacao URL?
Codificacao URL, tambem conhecida como codificacao percentual, e um mecanismo para representar em uma URL caracteres que nao sao permitidos ou que tem significado especial. Substitui caracteres inseguros por um sinal de porcentagem (%) seguido de dois digitos hexadecimais representando o codigo ASCII do caractere. Um espaco se torna %20 e um e comercial se torna %26. Nossa ferramenta de Codificacao e Decodificacao URL torna essas conversoes instantaneas e livres de erros.
Por que URLs precisam de codificacao?
URLs tem uma sintaxe estrita definida pela RFC 3986. Apenas um conjunto limitado de caracteres e permitido em uma URL sem codificacao:
- Caracteres nao reservados: A-Z, a-z, 0-9, hifen (-), underscore (_), ponto (.), til (~)
- Caracteres reservados: : / ? # [ ] @ ! $ & ' ( ) * + , ; = (tem significado especial na estrutura da URL)
Qualquer caractere fora deste conjunto deve ser codificado percentualmente.
Como funciona a codificacao percentual
O processo de codificacao converte cada caractere em sua representacao em bytes UTF-8, entao representa cada byte como um sinal de porcentagem seguido de dois digitos hexadecimais.
Caracteres comuns que precisam de codificacao
- Espaco: %20 (ou + em dados de formulario)
- & (e comercial): %26
- = (igual): %3D
- ? (interrogacao): %3F
- # (cerquilha): %23
- / (barra): %2F
Casos de uso da codificacao URL
Parametros de consulta
Ao passar dados atraves de strings de consulta URL, os valores devem ser corretamente codificados. Uma busca como gatos & caes se torna ?q=gatos%20%26%20caes.
Chamadas de API
APIs RESTful frequentemente requerem parametros codificados em requisicoes GET e POST.
Dados de formulario
Formularios HTML com tipo de conteudo application/x-www-form-urlencoded codificam todos os valores onde espacos sao representados como + em vez de %20.
URLs de redirecionamento
Quando uma URL e passada como parametro para um endpoint de redirecionamento, deve estar completamente codificada.
URLs internacionalizadas
URLs contendo caracteres nao latinos requerem codificacao percentual.
Como usar a ferramenta de codificacao URL
Insira qualquer texto para codifica-lo para uso em URL, ou cole uma string URL codificada para decodifica-la em texto legivel. A ferramenta funciona inteiramente no seu navegador sem enviar dados a servidores externos.
Melhores praticas
Sempre codifique a entrada do usuario antes de inseri-la em URLs. Use as funcoes de codificacao integradas como encodeURIComponent() em JavaScript ou urllib.parse.quote() em Python.