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.

Cómo codificar y decodificar URLs para APIs y parámetros de consulta

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+b sigue siendo a+b). Si quiere leer como espacio un + de estilo formulario, sustituya + por %20 antes de decodificar.
  • Un UTF-8 cortado a medias, como %E6%9D, o un % que no va seguido de dígitos hexadecimales, como 100%, da un error URI malformed. Compruebe que no se perdió el final al copiar.
  • Una notación antigua como %u3042 no 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.