PQ777GUIAS · FERRAMENTAS
PQ777 · FERRAMENTA INDEPENDENTE

Codificador e decodificador de URL

Codifique ou decodifique uma passagem de texto. Escolha o contexto para distinguir dados de separadores e veja o resultado sem abrir um endereço.

Sem cadastro · Processamento local · Exemplos explicados

Publicado em 17/10/2026 · Atualizado em

Converter texto de URL

Até 10.000 caracteres. Não cole senhas, tokens ou links de recuperação. O resultado é texto e não vira um link clicável. A conversão ocorre uma vez; nenhum destino é consultado.

Esta ferramenta processa entradas localmente e não coleta as operações. Registros técnicos de acesso ao site estão descritos na política de privacidade.

O que é URL encoded? E application/x-www-form-urlencoded?

URL encoded costuma indicar texto com caracteres representados por escapes percentuais, como %C3%A3. Já application/x-www-form-urlencoded é um formato de pares nome–valor: & separa campos, o primeiro = separa nome e valor, e + representa espaço. Ele pode aparecer na consulta de uma URL ou no corpo de um formulário; não é JSON nem criptografia.

Decodificar toda a cadeia antes de separar os campos pode confundir dados e separadores. Em nota=a%26b, o valor é a&b; esse & não inicia outro campo. Para converter apenas um valor, use o conversor acima. Para examinar vários campos juntos, use o leitor abaixo.

Ler campos URL encoded, sem enviar o formulário

Cole somente a query após o sinal ?, ou o corpo application/x-www-form-urlencoded. Até 10.000 caracteres e 200 campos. Não cole senhas, tokens, cookies, dados pessoais ou links de recuperação. A leitura fica neste navegador e não visita endereços.

Como interpretar o exemplo

O primeiro campo vira nome nome e valor João Silva. Os dois campos tag continuam separados e na ordem azul, verde: converter a saída em um objeto com uma única chave poderia perder um deles. O campo nota produz a+b, pois %2B significa um mais literal.

vazio= e flag são lidos com valor vazio, mas o leitor conserva o trecho original para mostrar que só o primeiro continha =. Ele também mostra nomes vazios e campos repetidos, sem decidir o que um servidor faria com eles.

Por que + muda para espaço, mas %2B não?

Na leitura de formulário, o mais cru é convertido em espaço antes da leitura dos escapes percentuais. Assim, x=a+b produz a b e x=a%2Bb produz a+b. Não aplique essa regra automaticamente a um caminho de URL ou ao modo componente.

Por que um erro aparece aqui de modo diferente do conversor?

Este leitor usa URLSearchParams, cuja leitura é tolerante: escapes incompletos podem ficar literais e bytes UTF-8 inválidos podem virar o caractere de substituição. A coluna de observação avisa quando a leitura estrita do nome ou valor falharia. O conversor de valor acima usa decodeURIComponent e interrompe a operação nesses casos. Um resultado exibido não prova que o texto de entrada estava correto.

Posso colar JSON, Base64 ou uma URL inteira?

O leitor não detecta esses formatos nem abre uma URL. Para evitar interpretar o endereço como nome de campo, ele recusa uma URL inteira. Extraia somente a query, ou use o leitor das partes de um endereço. JSON, Base64, multipart/form-data e uploads exigem outras ferramentas.

Método: URLSearchParams para a lista de pares; decodeURIComponent apenas como diagnóstico estrito. Referência normativa: WHATWG URL Standard, leitura de application/x-www-form-urlencoded. MDN: pares repetidos e limites de URLSearchParams. Consulta em 28/10/2026. Exemplos fictícios; sem certificação de segurança.

Como enviar application/x-www-form-urlencoded em um POST

Se a API espera um formulário, envie o corpo como pares nome e valor. Neste exemplo, o campo nota contém o texto a+b&c. O + e o & precisam ser codificados dentro do valor.

Com cURL

Use uma opção --data-urlencode por campo. O cURL usa POST e envia o tipo de conteúdo application/x-www-form-urlencoded por padrão. Troque o endereço de exemplo pelo endpoint da sua API.

curl https://example.com/form \
  --data-urlencode 'nome=João Silva' \
  --data-urlencode 'nota=a+b&c'

O corpo pode aparecer como nome=Jo%C3%A3o%20Silva&nota=a%2Bb%26c ou nome=Jo%C3%A3o+Silva&nota=a%2Bb%26c, conforme a versão do cURL. Os dois representam os mesmos campos neste formulário.

Com JavaScript

Passe o objeto URLSearchParams como corpo do fetch. Nesse caso, o navegador define o tipo de conteúdo do formulário automaticamente. O caminho /form é relativo ao seu próprio site.

const campos = new URLSearchParams([
  ["nome", "João Silva"],
  ["nota", "a+b&c"],
]);
await fetch("/form", { method: "POST", body: campos });

campos.toString() produz nome=Jo%C3%A3o+Silva&nota=a%2Bb%26c. Na leitura do formulário, tanto %20 quanto + representam o espaço, e %2B preserva o sinal de mais.

Como conferir antes de enviar

Cole um dos corpos de exemplo no leitor de campos. Você deve obter dois pares: nome com João Silva e nota com a+b&c. Se c aparecer como um terceiro campo, o & do valor foi enviado sem escape. Se o servidor responder que o tipo de conteúdo não é aceito, confira se o endpoint espera formulário ou JSON.

Manual do cURL · Padrão Fetch do WHATWG

Como funciona e qual pergunta responde

Uma sequência como %C3%A7 representa bytes codificados, não uma confirmação de segurança. O primeiro passo é decidir se você está tratando um valor isolado, uma estrutura de URL completa ou um valor de formulário. O mesmo sinal de mais pode ter função diferente nesses contextos.

No modo componente, os separadores como & e / entram como dados codificados. No modo URL completa, a codificação conserva separadores estruturais; a decodificação com decodeURI também mantém sequências reservadas como %2F e %26. Ela não equivale a decodificar todos os caracteres de um componente.

O modo valor de formulário trata uma única cadeia, não uma query inteira: espaço vira + na codificação e + vira espaço na leitura. Um mais literal precisa aparecer como %2B. Não cole a=1&b=2 esperando que a ferramenta separe dois campos.

Quatro exemplos para conferir

Casos fictícios preparados para conferir as regras e os limites do formulário.

Acento e separador como dados

No modo componente, “ação & café” vira ação codificada como a%C3%A7%C3%A3o%20%26%20caf%C3%A9. O & foi convertido para %26, em vez de ser usado como separador de outro campo.

Mais literal e espaço

O texto “a+b c” vira a%2Bb%20c no modo componente e a%2Bb+c no modo formulário. Na leitura de formulário, %2B continua sendo o mais literal, enquanto o + não escapado representa espaço.

Uma passagem por vez

Decodificar %252F uma vez produz %2F. Uma segunda passagem produziria /. O formulário não repete a operação automaticamente: repetições podem transformar dados em separadores.

Texto malformado

Ao decodificar %G1 ou %E0%A4%A, a ferramenta informa erro. Ela exige pares hexadecimais depois de % e bytes UTF-8 válidos; não substitui o texto inválido por uma interpretação adivinhada.

Perguntas e limites

Por que %2F pode continuar no resultado?

No modo URL completa, decodeURI preserva escapes de certos caracteres reservados. Se a tarefa for ler um valor isolado que contém uma barra, escolha componente e confira o contexto antes de reutilizar a saída.

Isso também decodifica Base64 ou HTML?

Não. Base64, entidades como & e percent-encoding são formatos diferentes. Este formulário somente executa os três modos de conversão de URL descritos aqui.

Posso codificar uma URL que já tem %20?

A codificação pode transformar o próprio % em %25. Confirme se a entrada já está codificada. A ferramenta não tenta detectar ou corrigir automaticamente dupla codificação.

A página guarda o texto ou visita o destino?

Este conversor não guarda as entradas nem faz requisições com elas. O site continua tendo registros técnicos de acesso conforme a política de privacidade. Copiar ou compartilhar a saída em outro serviço é uma ação separada.

Casos de codificação e de leitura de texto

Os cenários abaixo são fictícios. Use as contas e os textos para conferir uma interpretação. Alguns casos exigem uma operação auxiliar ou demonstram um limite que o formulário não resolve sozinho. Eles não são dados de uma empresa, certificação de segurança ou promessa de resultado.

Um emoji em um componente

Situação: O valor isolado é “teste 😀”, no modo componente e na operação codificar.

Texto exato do exercício: teste 😀

Conferência: A saída é teste%20%F0%9F%98%80. O espaço recebe %20 e o emoji usa quatro bytes UTF-8, cada um representado por uma sequência percentual.

Cada símbolo visível sempre gera um único par percentual?

Não. A codificação trabalha com bytes. Um caractere Unicode pode ocupar vários bytes, e uma sequência visual pode conter mais de um caractere.

Um sinal de porcentagem que faz parte do texto

Situação: O texto não codificado é “100% concluído”.

Texto exato do exercício: 100% concluído

Conferência: Ao codificar como componente, a saída é 100%25%20conclu%C3%ADdo. O % literal recebe %25; ele não é tratado como início de um escape previamente válido.

O conversor reconhece automaticamente um percentual escrito em linguagem comum?

A direção é escolhida pelo usuário. Texto comum com % deve ser codificado; tentar decodificá-lo pode causar erro de sequência.

Uma pergunta como valor isolado

Situação: O valor de um campo é “qual?sim”, e não uma URL completa.

Texto exato do exercício: qual?sim

Conferência: No modo componente, a saída é qual%3Fsim. O sinal ? passa a ser dado codificado em vez de um possível delimitador estrutural.

Qual modo escolher quando ? pertence ao conteúdo do campo?

Escolha componente para esse valor isolado. A montagem da URL que o receberá é uma etapa distinta.

O sinal de igualdade dentro do conteúdo

Situação: Um campo fictício contém o texto “a=b”.

Texto exato do exercício: a=b

Conferência: Codificar como componente produz a%3Db. A saída não declara um novo par de parâmetro; é a representação de um único valor.

Um igual no resultado decodificado significa que havia dois campos?

Não. Decodificar um valor não reconstrói automaticamente a estrutura original de uma consulta.

Uma cerquilha que pertence a um nome

Situação: O texto isolado é “cap#2”, que será usado como dado de um componente.

Texto exato do exercício: cap#2

Conferência: A codificação gera cap%232. Se # fosse inserido cru em uma URL completa, poderia iniciar o fragmento em vez de permanecer dentro do valor pretendido.

Codificar # cria uma âncora?

Não. Aqui a conversão faz o contrário: representa o caractere como dado. A função final depende de onde esse valor for colocado.

Pontuação que encodeURIComponent conserva

Situação: No modo componente, o texto é “a!b'c(d)*”.

Texto exato do exercício: a!b'c(d)*

Conferência: A função mantém esses caracteres nessa saída. O modo não promete uma política adicional que escape toda pontuação reservada por outros contextos ou protocolos.

Este modo aplica toda variante de codificação RFC?

Não. O método declara a função usada. Se outro sistema exigir regras adicionais, compare sua especificação antes de reutilizar o texto.

Uma barra dentro de um valor de componente

Situação: O texto isolado é “arquivo/a”, sem a intenção de montar uma URL inteira.

Texto exato do exercício: arquivo/a

Conferência: O modo componente produz arquivo%2Fa. Já a codificação como URL completa conserva a barra estrutural. A escolha deve refletir a função pretendida do texto.

É correto usar o mesmo modo para segmento e URL inteira?

Não automaticamente. Um separador que é dado em um contexto pode ser estrutura no outro.

Textos visualmente parecidos com sequências diferentes

Situação: Compare a letra “é” composta com “e” seguida de acento agudo combinante, duas representações Unicode do exemplo.

Texto exato do exercício: é

Conferência: A primeira codifica como %C3%A9; a segunda como e%CC%81. O conversor não normaliza automaticamente essas representações para uma forma comum.

A aparência igual garante igualdade dos valores codificados?

Não. Compare a sequência de caracteres e as regras de normalização da aplicação, sem presumir equivalência pelo desenho na tela.

Uma quebra de linha dentro de um valor

Situação: A cadeia de teste tem “linha1”, uma quebra LF e depois “linha2”.

Texto exato do exercício: linha1 linha2

Conferência: No modo componente, ela vira linha1%0Alinha2. A saída decodificada é texto; este conversor não a executa nem a usa como cabeçalho ou endereço de navegação.

Posso reutilizar texto decodificado em qualquer outro campo?

Não sem conferir o contexto de destino. Caracteres de controle podem ser inadequados para URLs completas, cabeçalhos ou campos com regras diferentes.

Espaços nas extremidades são parte da entrada

Situação: O texto de teste contém um espaço, depois x e mais um espaço.

Texto exato do exercício: x

Conferência: O modo componente retorna %20x%20. Diferentemente de um formulário que remove espaços externos, este conversor preserva a cadeia digitada.

Por que apareceram espaços que eu não percebi?

Eles podem fazer parte do texto copiado. Confira a origem e a saída antes de substituir valores em outro sistema.

Pares hexadecimais em letras minúsculas

Situação: A operação é decodificar o componente %c3%a1.

Texto exato do exercício: %c3%a1

Conferência: A saída é á. A diferença entre letras maiúsculas e minúsculas nos dígitos hexadecimais não altera os bytes representados por esse exemplo.

Um escape em minúsculas indica que o conteúdo é falso?

Não. A grafia hexadecimal, isoladamente, não avalia identidade ou reputação. A ferramenta só converte texto.

Uma codificação UTF-8 inválida

Situação: A entrada de teste para decodificar é %C0%AF.

Texto exato do exercício: %C0%AF

Conferência: O formulário informa erro de sequência inválida. Ele não aceita essa representação UTF-8 como uma maneira alternativa de escrever uma barra.

Um par hexadecimal válido basta para a decodificação funcionar?

Não. Além dos pares depois de %, a sequência de bytes precisa representar caracteres UTF-8 válidos para a função escolhida.

O valor decodificado parece uma consulta inteira

Situação: O componente de teste é a%3D1%26b%3D2.

Texto exato do exercício: a%3D1%26b%3D2

Conferência: Uma passagem produz a=1&b=2 como texto. O conversor não separa os pares nem demonstra que a origem tinha uma consulta com dois parâmetros.

Quando devo separar parâmetros de uma URL?

Primeiro interprete a estrutura da URL e identifique sua consulta. Decodificar todos os dados antes dessa separação pode apagar a distinção entre dados e delimitadores.

Separadores reservados numa URL completa

Situação: A operação é decodificar %23%3F no modo URL completa.

Texto exato do exercício: %23%3F

Conferência: A saída conserva %23%3F, enquanto o modo componente produziria #?. O modo completo evita converter esses escapes reservados em estrutura diferente.

O modo completo falhou porque deixou escapes visíveis?

Não nesse caso. É o comportamento previsto de decodeURI; escolha componente somente quando estiver tratando os dados de um componente.

Uma sequência que tentaria representar um substituto isolado

Situação: A cadeia de teste %ED%A0%80 é enviada à operação decodificar componente.

Texto exato do exercício: %ED%A0%80

Conferência: A função informa erro: esses bytes não formam um caractere UTF-8 válido aceito pela operação. Ela não cria um caractere substituto por adivinhação.

O conversor repara automaticamente Unicode malformado na leitura?

Não. A leitura estrita interrompe a operação. Verifique a codificação no sistema que produziu o texto em vez de confiar numa reparação silenciosa.

Exemplos e respostas preparados pelo PQ777. As fontes conceituais e os limites de implementação estão no método do guia. A conferência aritmética e de transformação não equivale a revisão profissional certificada.

Pratique este assunto

Quer repetir a conta ou a leitura com outros dados? A lista de 160 exercícios de codificação e decodificação de url com respostas organiza vinte situações por tipo. Tente antes de abrir a resolução.

Método e fontes

O modo componente usa encodeURIComponent/decodeURIComponent; o modo completo usa encodeURI/decodeURI. Para codificar um valor de formulário, usa URLSearchParams; para ler, troca + por espaço antes de decodeURIComponent. A saída é inserida como texto, nunca como HTML. A ferramenta não faz análise de reputação nem valida o conteúdo de um endereço.

Referências consultadas em 17/10/2026. Nenhuma instituição indicada certifica os resultados do PQ777.

Continue pela próxima tarefa