Herramientas mencionadas en este artículo
Abre la herramienta en el navegador mientras lees y prueba el flujo al instante.
Por qué las URLs contienen cadenas como %20 y %2F
Las URLs solo pueden usar ciertos caracteres con seguridad. Los espacios, el texto no inglés, las barras dentro de los valores, los símbolos y los caracteres reservados a menudo necesitan codificarse por porcentajes antes de colocarse en una URL.

El Codificador y decodificador de URL de DevToolKits te ayuda a convertir texto legible en cadenas seguras para URL y a decodificar valores existentes de nuevo a texto.
Ejemplo: poner una palabra clave de búsqueda en una URL
Supón que quieres poner la palabra clave de búsqueda Tokyo Station cafe en una URL. Los espacios pueden romper la visualización o la copia en algunos entornos.
Tokyo Station cafe
Codificada en URL, queda así:
Tokyo%20Station%20cafe
Colocada en un parámetro de consulta, produce una URL para compartir:
https://example.com/search?q=Tokyo%20Station%20cafe
Confirmar que se decodifica de vuelta a la cadena original ayuda a detectar condiciones de búsqueda corruptas o caracteres dañados.
Cuándo importa la codificación
La codificación es especialmente importante al construir URLs de búsqueda, URLs de callback, parámetros de consulta de API, destinos de redirección y enlaces de seguimiento. Si un valor no se codifica correctamente, el navegador o el servidor pueden dividirlo por el carácter equivocado e interpretarlo como un parámetro diferente.
Por ejemplo, un espacio puede aparecer como %20 o + según el contexto. Una barra dentro de un valor de consulta puede necesitar un tratamiento distinto al de una barra en una ruta.
Ejemplo: no trates dos veces una URL de retorno
En OAuth y en las integraciones externas, a veces se coloca una URL dentro de otra como valor.
https://app.example.com/callback?next=/dashboard?tab=billing
Cuando pones un valor así en redirect_uri, codifica la parte de URL que pasas como valor.
redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback%3Fnext%3D%2Fdashboard%3Ftab%3Dbilling
Ten cuidado con el caso en que un valor que ya está codificado se codifica otra vez. Si un % se ha convertido en %25, es probable que haya doble codificación. Comprobar el resultado decodificado y si vuelve a la URL esperada facilita localizar la causa.
Inspecciona las cadenas de consulta por separado
Cuando una URL tiene muchos parámetros, usa el Conversor de parámetros de URL a JSON para dividir la cadena de consulta en claves y valores. Esto hace que los enlaces de seguimiento y las solicitudes de API sean mucho más fáciles de revisar antes de compartirlos o desplegarlos.
Reglas de conversión de esta herramienta: convertir un valor, no la URL completa
La herramienta se comporta igual que encodeURIComponent / decodeURIComponent de JavaScript. Estos son resultados reales de conversión.
| Entrada | Codificado | Observación |
|---|---|---|
a b+c |
a%20b%2Bc |
Un espacio pasa a %20, no a +. Un + pasa a %2B |
a/b:c@d |
a%2Fb%3Ac%40d |
/, : y @ también se codifican |
https://example.com/a b?x=1&y=2#top |
https%3A%2F%2Fexample.com%2Fa%20b%3Fx%3D1%26y%3D2%23top |
Si introduce una URL completa, se convierten incluso los separadores : / ? & = # y deja de funcionar como enlace |
it's (ok)! *~-_. |
it's%20(ok)!%20*~-_. |
Las letras, los dígitos y ! ' ( ) * ~ - _ . no se modifican |
😀 |
%F0%9F%98%80 |
Los cuatro bytes UTF-8 se convierten en cuatro %XX |
100% |
100%25 |
El propio % pasa a %25 |
Por eso está pensada para partes de una URL, como el valor de una consulta, un único segmento de ruta o el valor de redirect_uri. Convierta solo el valor, no la URL completa, y añádalo usted mismo después de ?q=. En «Ámbito» también puede elegir la URL completa (encodeURI, que conserva : / ? & = # y convierte solo los espacios y el texto no ASCII) o el estilo de formulario (espacio como +, y + vuelve a ser un espacio al decodificar), además de un valor solo (encodeURIComponent).
Conocer el comportamiento de la decodificación también ayuda a localizar los errores.
- El
+no se convierte de nuevo en espacio (a+bsigue siendoa+b). Si quiere leer como espacio un+de estilo formulario, sustituya+por%20antes de decodificar. - Un UTF-8 cortado a medias, como
%E6%9D, o un%que no va seguido de dígitos hexadecimales, como100%, da un errorURI malformed. Compruebe que no se perdió el final al copiar. - Una notación antigua como
%u3042no se puede decodificar y da un error.
Resumen
La codificación de URL es un pequeño detalle que evita enlaces rotos, solicitudes de API malformadas y errores de seguimiento. Decodifica lo que recibes, codifica lo que envías y revisa las cadenas de consulta largas como datos estructurados siempre que sea posible.
Preguntas frecuentes
¿%20 y + son ambos espacios?
Ambos representan un espacio, pero el contexto difiere. En las rutas de URL y la codificación por porcentajes, un espacio es %20. En las cadenas de consulta (application/x-www-form-urlencoded), un espacio puede representarse como +. Comprueba el formato que espera tu API o formulario y verifica la cadena real que envías con el Codificador y decodificador de URL.
¿Cómo detecto una doble codificación?
Un % normalmente se codifica como %25 cuando forma parte de un valor. Si el resultado decodificado contiene %25, o no vuelve a la URL original tras una decodificación, probablemente tengas un valor doblemente codificado: una cadena ya codificada que se codificó de nuevo. Decodificar una vez y comprobar si vuelve a la URL esperada ayuda a aislar la causa.
¿Los caracteres no ingleses en una URL siempre necesitan codificación?
La barra de direcciones puede mostrarlos directamente, pero al compartir como enlace o pasar a una API, codifícalos para evitar la corrupción según el entorno. Por ejemplo, 東京 se codifica como su secuencia de bytes UTF-8, %E6%9D%B1%E4%BA%AC.
