O que é Decodificação de URL?
A decodificação de URL é o processo inverso da codificação de URL. Ela converte strings codificadas em percentual — onde caracteres especiais foram substituídos por um sinal de % seguido por dois dígitos hexadecimais — de volta aos seus caracteres originais e legíveis por humanos. Por exemplo, hello%20world se torna hello world, e caf%C3%A9 se torna café.
Quando navegadores, servidores e APIs recebem URLs, eles decodificam automaticamente as sequências codificadas em percentual antes de processar a requisição. No entanto, os desenvolvedores frequentemente precisam decodificar URLs manualmente — por exemplo, ao ler respostas de API, inspecionar parâmetros de consulta em logs de servidor, ou depurar dados codificados recebidos de um serviço de terceiros.
A decodificação de URL é definida pelo mesmo padrão da codificação de URL: RFC 3986 (sintaxe de identificador uniforme de recursos). Tanto + (representando um espaço em strings de consulta) quanto %20 (a codificação estrita para espaço) são tratados corretamente por esta ferramenta, que utiliza a função nativa do PHP urldecode().
Cenários comuns onde você precisará de decodificação de URL incluem: ler links de e-mail codificados, examinar parâmetros de requisição HTTP registrados, trabalhar com tokens de autenticação OAuth e depurar integrações de API onde os parâmetros são passados de forma codificada.
Como Usar Este Decodificador de URL
- Cole sua string codificada: Na área de texto da esquerda, cole a URL codificada em percentual, a string de consulta ou qualquer valor codificado que você deseje decodificar.
- Clique em "Decodificar URL": A ferramenta processa sua entrada instantaneamente e exibe o resultado decodificado e legível por humanos à direita.
- Copie o resultado: Clique em Copiar Saída para copiar a string decodificada para sua área de transferência para uso em seu código ou documentação.
- Experimente URLs completas: Você pode colar uma URL codificada completa (incluindo o protocolo e o caminho) e toda a string será decodificada, tornando-a mais fácil de ler e entender.
A ferramenta lida com todos os caracteres codificados em percentual, incluindo %20 (espaço), %26 (&), %3D (=), %2F (/), bem como caracteres codificados UTF-8 multibyte como %C3%A9 (é) e sequências de emoji.
Por que a Decodificação de URL é Importante para Desenvolvedores?
A decodificação de URL é uma habilidade e uma ferramenta essenciais para qualquer desenvolvedor web ou administrador de sistema. Eis o porquê:
- Depuração de Integrações de API: Ao trabalhar com APIs de terceiros, os parâmetros de consulta são frequentemente codificados em percentual em respostas, cabeçalhos e URIs de redirecionamento. Decodificá-los manualmente permite inspecionar valores rapidamente sem escrever código.
- Leitura de Logs de Servidor: Logs de acesso de servidores web (Apache, Nginx) registram as URLs de requisições de entrada em sua forma bruta e codificada. Decodificá-los torna muito mais fácil entender o que seus usuários estavam fazendo ou diagnosticar erros.
- Fluxos de Autenticação OAuth e OIDC: Fluxos de autenticação OAuth 2.0 e OIDC usam URIs de redirecionamento e parâmetros de estado codificados. Decodificar esses valores é necessário ao depurar problemas de autorização.
- Rastreamento de Links de E-mail: Plataformas de marketing por e-mail codificam parâmetros de rastreamento em URLs. Decodificar esses links revela a URL de destino original e metadados de rastreamento.
- Inspeção de Dados de Formulário: Submissões de formulário GET codificam valores de campo na URL. Decodificar a string de consulta facilita a leitura dos dados enviados sem um painel de ferramentas de desenvolvedor do navegador.
- Pipelines de Processamento de Dados: Pipelines ETL, scrapers de dados e rastreadores da web frequentemente encontram URLs codificadas em sitemaps, feeds e exportações de dados que devem ser decodificadas para processamento.
Exemplos de Decodificação de URL
hello+world https%3A%2F%2Fexample.com%2Fsearch%3Fq%3Dcats+%26+dogs user%40email.com na%C3%AFve+r%C3%A9sum%C3%A9
hello world https://example.com/search?q=cats & dogs [email protected] naïve résumé
Como você pode ver, todas as sequências codificadas em percentual são restauradas aos seus caracteres originais. Sequências UTF-8 multibyte como %C3%AF (ï) e %C3%A9 (é) são corretamente combinadas e decodificadas para seus caracteres Unicode.
Precisa codificar uma URL em vez disso? Use nossa ferramenta complementar Codificador de URL.