Cómo codificar parámetros de URL sin romper un enlace

Qué se codifica en un parámetro de URL

Una URL tiene partes con funciones distintas. El signo de interrogación inicia la consulta, el igual separa el nombre de un parámetro de su valor y el ampersand separa parámetros. Si escribes un valor que contiene esos caracteres tal cual, el navegador o el servidor pueden interpretarlos como estructura del enlace y no como parte del texto. Codificar evita esa confusión al representar determinados caracteres con secuencias que empiezan por %. No cambia lo que quieres comunicar; cambia cómo viaja ese valor dentro de la dirección.

La unidad de trabajo es el valor de un parámetro, no el enlace entero. Por ejemplo, en `https://ejemplo.test/buscar?consulta=...`, lo que debes preparar es el texto que ocupará los puntos suspensivos. El Codificador de URL de Nítido Tools aplica `encodeURIComponent` al texto que escribes. Es una operación adecuada para preparar un componente de URL, como una búsqueda, un nombre de archivo o una etiqueta, antes de insertarlo en una estructura que ya conoces.

Codifica el valor, no la dirección completa

Conserva sin tocar el protocolo, el dominio, la ruta y los separadores que forman el enlace. Es decir, mantén `https://ejemplo.test/buscar?consulta=` y codifica solo `café & té / oferta`. Después une ambas partes. Así el signo `?`, el signo `=` y el separador entre parámetros siguen haciendo su trabajo, mientras que los caracteres incluidos en el texto quedan representados de forma segura para ese componente.

Si pegas la URL completa en la herramienta, los dos puntos, las barras, la interrogación, el igual y los ampersands también se convertirán en texto codificado. El resultado puede ser válido como un componente aislado, pero deja de ser una dirección que puedas abrir directamente. No es un fallo de la herramienta: es la consecuencia de usar una función de componentes sobre una URL completa. Vuelve al original y repite la operación solo con cada valor.

Tampoco confundas codificar con montar una consulta completa. La herramienta no separa pares como `producto=...&color=...`, no añade nombres de parámetros y no comprueba que el dominio exista. Si necesitas dos valores, codifica cada uno por separado y constrúyelos con sus nombres: `producto=valor-codificado&color=otro-valor-codificado`. Revisa la documentación del servicio que recibirá el enlace antes de decidir esos nombres.

Ejemplo reproducible con una búsqueda

Supón que quieres crear una búsqueda de `café & té / oferta` en un sitio de pruebas. Abre el Codificador de URL de Nítido Tools, pega exactamente ese texto en Entrada y pulsa Procesar. La salida debe ser `caf%C3%A9%20%26%20t%C3%A9%20%2F%20oferta`. La tilde se representa mediante secuencias UTF-8 y los espacios aparecen como `%20`; el ampersand y la barra también dejan de actuar como separadores o parte de la ruta.

Ahora une manualmente la salida a una base que controles: `https://ejemplo.test/buscar?consulta=caf%C3%A9%20%26%20t%C3%A9%20%2F%20oferta`. En esa dirección hay un único `?` que inicia la consulta, un único `=` que separa el nombre `consulta` de su valor y ningún ampersand sin codificar dentro del valor. Si después añades un filtro, déjalo fuera del valor: `https://ejemplo.test/buscar?consulta=caf%C3%A9%20%26%20t%C3%A9%20%2F%20oferta&orden=precio`.

Haz una prueba pequeña antes de usar un enlace en un correo, un QR o una integración. Copia la dirección completa en un entorno de pruebas que controles y comprueba que el destino recibe o muestra exactamente `café & té / oferta`. Si no tienes un destino de prueba, al menos revisa que no haya espacios literales, un `&` dentro del valor ni un `%` añadido por error. Conserva el texto original junto a la salida: comparar ambos permite detectar un recorte o una doble codificación.

Errores que suelen romper el enlace

El primer error es codificar dos veces. Si ya tienes `caf%C3%A9%20` y lo vuelves a pasar por la herramienta, el signo `%` se transforma en `%25`; verás una salida que contiene algo como `caf%25C3%25A9%2520`. Para evitarlo, parte siempre del texto legible original y codifícalo una sola vez. No intentes arreglar una cadena dudosa aplicando Procesar repetidamente: identifica primero en qué punto se generó.

Otro error habitual es reemplazar espacios por `+` sin saber qué formato exige el receptor. Esta herramienta usa únicamente `encodeURIComponent`, por lo que un espacio se convierte en `%20` y un signo más que formes parte del texto se convierte en `%2B`. Algunos envíos de formularios tienen reglas específicas para usar `+` en lugar de espacios, pero eso no convierte automáticamente cualquier URL en un formulario. Sigue el formato documentado por la API o la aplicación de destino.

Por último, no pegues secretos en un parámetro solo porque el resultado parezca menos legible. La codificación es reversible y no aporta control de acceso. Evita incluir contraseñas, tokens o datos personales en enlaces compartibles. Si una plataforma requiere autenticación o un enlace temporal, utiliza el mecanismo que esa plataforma proporciona en lugar de intentar ocultar la información mediante porcentajes.

Límites reales del Codificador de URL

La implementación actual de Nítido Tools solo codifica: aplica `encodeURIComponent` y ofrece el resultado para copiarlo. No decodifica cadenas ya escapadas, no detecta automáticamente una URL completa, no valida un esquema ni comprueba si el enlace final responde. Por tanto, una salida correcta no garantiza que el parámetro tenga el nombre esperado, que el servidor acepte ese valor o que la página de destino exista.

También hay caracteres que `encodeURIComponent` deja sin escapar y formatos con requisitos propios, como cabeceras HTTP o reglas estrictas de una API. La herramienta no promete cubrir esas variantes ni sustituye un constructor de URL de tu lenguaje. Si estás desarrollando una integración, prueba un caso con acentos, espacios, `&`, `+` y `/` contra el receptor real. Ante un mensaje genérico de formato no válido, revisa la entrada y prueba con un texto más corto para aislar el carácter problemático.

Privacidad local y comprobación final

El texto que introduces en el Codificador de URL se transforma en el navegador; Nítido Tools no necesita enviarlo a un servidor para producir el resultado. Es útil para preparar valores internos o búsquedas sin subirlos a un conversor externo. Aun así, aplica el principio de mínima información: no pegues contraseñas, tokens ni datos personales que no hagan falta, y recuerda que compartir la URL resultante puede compartir también su consulta.

Antes de copiar la salida a producción, haz tres comprobaciones: usa el texto original como entrada, confirma que solo has codificado el valor y prueba el enlace completo en el destino previsto. Revisa además que no haya quedado una versión antigua en el cuadro de Resultado. La herramienta agiliza la conversión, pero la decisión sobre qué información puede viajar en un enlace y cómo debe interpretarla el servicio receptor sigue siendo tuya.

Preguntas frecuentes

¿La herramienta puede decodificar una URL?

No. La implementación actual solo aplica encodeURIComponent al texto de entrada. Si recibes una cadena con %20 o %C3%A9, no la pegues esperando recuperar el texto original con esta herramienta.

¿Debo codificar una URL completa?

No en este flujo. Conserva la estructura de la dirección y codifica por separado cada valor que vaya después de un signo igual. Codificar la URL completa escaparía también sus separadores.

¿Por qué aparece %20 en vez de un espacio?

Porque encodeURIComponent representa el espacio como %20. La herramienta no convierte espacios en +; usa ese otro formato solo si la documentación concreta del receptor lo exige.

¿El resultado protege un dato sensible?

No. La codificación sirve para que un componente no altere la estructura de un enlace, no para ocultarlo. No incluyas secretos ni datos personales innecesarios en una URL que puedas copiar, guardar o compartir.