Codificador y Decodificador de URL

Codifique o decodifique componentes URL y parámetros de consulta de forma segura en su navegador según el estándar RFC 3986.

¿Qué es la Codificación Porcentual de URL? (Estándar RFC 3986)

La Codificación de URL (definida técnicamente como Codificación Porcentual / Percent-Encoding bajo la especificación de Identificadores Uniformes de Recursos RFC 3986) es el mecanismo estándar para incrustar datos arbitrarios de forma segura dentro de direcciones URL web.

Los protocolos de comunicación centrales de internet restringen históricamente las URL exclusivamente a un subconjunto de caracteres US-ASCII imprimibles. Los caracteres fuera de este rango (como tildes, alfabetos cirílico, griego, escrituras asiáticas y emojis) o caracteres que poseen significados estructurales reservados en la sintaxis URI (como ?, &, = y /) no pueden enviarse literalmente a través de la red.

Para transmitir estos caracteres de forma segura, la codificación porcentual traduce primero el carácter a sus bytes UTF-8 subyacentes (de 1 a 4 bytes) y luego representa cada byte individual como un signo de porcentaje (%) seguido de un número hexadecimal de dos caracteres en mayúsculas (por ejemplo, el espacio se convierte en %20 y el emoji del cohete 🚀 se convierte en %F0%9F%9A%80).

encodeURIComponent vs. encodeURI vs. URLSearchParams

Un error frecuente en ingeniería web es utilizar la función de codificación incorrecta para la parte equivocada de una URL:

  • encodeURIComponent() (Nivel de Componente): Codifica todo excepto los caracteres estándar no reservados (A–Z a–z 0–9 - _ . ! ~ * ' ( )). Escapa activamente los delimitadores reservados de URL como / ? : @ & = + $ #. Utilice siempre esta opción al codificar el valor de un parámetro de consulta individual (por ejemplo, al codificar una URL de retorno dentro de ?redirect_url=https%3A%2F%2Fapp.com%2Fdashboard).
  • encodeURI() (Nivel de URL Completa): Deja intactos los delimitadores estructurales del protocolo URI (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) para que la dirección completa siga siendo funcional y clicable, escapando únicamente los espacios y bytes UTF-8 no ASCII.
  • URLSearchParams (API Estándar Moderna): El estándar recomendado en navegadores y Node.js para construir cadenas de consulta (const params = new URLSearchParams({ q: "término de búsqueda" })). Codifica automáticamente claves y valores conforme a la especificación de formularios HTML.

El Dilema del Espacio: Por Qué %20 vs. + Causa Errores en Producción

Los desarrolladores observan con frecuencia que los espacios aparecen tanto como %20 como con el signo +. Estos provienen de dos especificaciones de internet distintas:

  • Rutas URI (RFC 3986): En los segmentos de ruta de una URL (como /documentos/informe%20anual.pdf), los espacios deben codificarse como %20. En un segmento de ruta, un signo más literal (+) representa un carácter más real, ¡no un espacio!
  • Cadenas de Consulta (application/x-www-form-urlencoded): En formularios web estándar y parámetros de consulta, los espacios se codifican históricamente como +, mientras que un signo más literal debe escaparse como %2B.

La Trampa: Si una API espera codificación porcentual estándar RFC 3986 y un cliente envía c++ en lugar de c%2B%2B, el servidor decodifica los signos más como espacios, corrompiendo la consulta de búsqueda en "c ".

Implicaciones de Seguridad: Doble Codificación y Path Traversal

Una codificación y decodificación inadecuadas de URL introducen graves vulnerabilidades de seguridad:

  • Doble Codificación Porcentual: Si una aplicación codifica dos veces una cadena ya codificada, %20 se convierte en %2520 (porque el propio carácter % se codifica como %25). Si un firewall WAF intermedio decodifica una vez y permite pasar la solicitud, pero la aplicación backend decodifica por segunda vez, los filtros de seguridad pueden ser evadidos.
  • Evasión mediante Path Traversal: Los atacantes suelen codificar los caracteres de punto y barra diagonal (p. ej., %2e%2e%2f para ../) con el fin de eludir filtros básicos de seguridad por coincidencia de cadenas y acceder a archivos sensibles del sistema como /etc/passwd.

Guía Rápida para Desarrolladores en Distintos Lenguajes de Programación

Así es como se codifican y decodifican correctamente las URL en los principales entornos backend:

  • JavaScript: encodeURIComponent(str) y decodeURIComponent(str).
  • Python 3: from urllib.parse import quote, unquote; quote(str) (RFC 3986) o quote_plus(str) (formularios).
  • Go: import "net/url"; url.QueryEscape(str) o url.PathEscape(str).
  • PHP: rawurlencode($str) (RFC 3986 %20) frente a urlencode($str) (+).

Casos de Uso Prácticos en el Mundo Real

  • Corregir cadenas de consulta rotas: Codifique porcentualmente valores de parámetros que contengan espacios, signos ampersand (&), signos de interrogación (?) o símbolos almohadilla (#) para que no rompan el análisis de la URL.
  • Preparar parámetros seguros para solicitudes API: Codifique cadenas de búsqueda o valores de filtro proporcionados por el usuario antes de concatenarlos en una URL de solicitud.
  • Rastrear cadenas complejas de redirección: Decodifique parámetros de consulta anidados como redirect_uri o return_to para leer la URL de destino exacta.
  • Manejar caracteres internacionalizados: Codifique texto no ASCII o Unicode en secuencias UTF-8 porcentuales válidas para una transmisión segura en URLs.
  • Depurar errores de doble codificación: Decodifique una URL mal formada paso a paso para identificar dónde se codificó accidentalmente un parámetro dos veces (p. ej., %2520 en lugar de %20).

Privacidad Absoluta

Sus URL y cadenas de consulta se procesan localmente. OmniTools opera bajo una estricta arquitectura de "Cero Subidas a Servidores". Cuando codifica o decodifica enlaces de seguimiento, URLs de sesión, callbacks de OAuth o parámetros de consulta de API que contienen tokens confidenciales, toda la traducción de caracteres se ejecuta localmente en el entorno de su navegador.

Ninguna dirección URL ni cadena de consulta se registra, envía a través de la red ni almacena en servidores remotos.

Preguntas Frecuentes (FAQ)

¿Para qué sirve codificar y decodificar URLs (Percent-Encoding / RFC 3986)?

La codificación porcentual convierte espacios (%20) y caracteres reservados o acentuados UTF-8 en secuencias hexadecimales seguras para que los parámetros de consulta viajen sin corromperse en enlaces y APIs.

¿Cuándo debo codificar un parámetro de consulta frente a una URL completa?

Al pasar valores dentro de parámetros GET (?q=valor), codifique todos los delimitadores reservados (&, =, ?, /) para evitar que rompan la estructura de la URL.