Herramientas mencionadas en este artículo
Abre la herramienta en el navegador mientras lees y prueba el flujo al instante.
Las URLs largas son difíciles de revisar como texto plano
Los enlaces de campaña y las solicitudes de API suelen contener muchos parámetros: utm_source, utm_medium, page, sort, filter y más. Cuando la URL se hace larga, es fácil pasar por alto erratas, claves duplicadas o valores de seguimiento inesperados.

El Convertidor de parámetros de URL a JSON convierte una URL o cadena de consulta en un objeto JSON legible para revisar con claridad cada clave y valor.
Comprobaciones de UTM antes de publicar
Los parámetros UTM afectan a cómo se agrupa el tráfico en las herramientas de analítica. Si utm_source o utm_campaign tienen mayúsculas o grafías inconsistentes, los resultados pueden dividirse en campañas separadas. Antes de compartir un enlace, conviértelo a JSON y confirma que los valores siguen tu convención de nombres.
Depuración de solicitudes de API
En los endpoints GET, los parámetros de consulta suelen representar filtros, paginación, orden y feature flags. Convertirlos a JSON facilita pegar la solicitud en documentación e incidencias, para que el equipo reproduzca las mismas condiciones.
Considera revisar una URL como esta:
https://example.com/search?q=jwt&page=2&sort=updated&tag=security&tag=api
Como JSON, es fácil ver si page se pasa como cadena, si tag se especifica varias veces y si se colaron valores vacíos. También puedes detectar un desajuste donde la API espera tag=security,api pero el frontend envía tag=security&tag=api.
Si los valores están codificados en porcentaje, el Codificador y decodificador de URL ayuda a confirmar qué significa el texto.
Cómo documentarlo en una incidencia
Para los informes de errores, pegar el JSON descompuesto junto a los valores esperados reproduce el problema más rápido que solo la URL completa.
{
"q": "jwt",
"page": "2",
"sort": "updated",
"tag": ["security", "api"]
}
En esta forma, puedes revisar por separado el término de búsqueda, la paginación, el orden y las condiciones de filtro. Reduce la carga de leer una URL larga y permite a los revisores centrarse solo en las diferencias.
Trampas de la codificación y de la notación de arrays
Al revisar parámetros de URL, la codificación y la notación de arrays son fáciles de pasar por alto.
+frente a%20: en una cadena de consulta un espacio puede codificarse como+(según la especificaciónapplication/x-www-form-urlencoded), mientras que la ruta usa%20. Ambos significan un espacio, pero si se decodifican de la forma equivocada el+se queda tal cual.- La notación de arrays difiere entre servicios: para los mismos “varios valores” existen
tag=a&tag=b(repetido),tag=a,b(separado por comas) ytag[]=a&tag[]=b(corchetes). Si el front end y la API parten de supuestos distintos, solo uno de los lados recibe los valores. - Codificación olvidada: si un valor contiene
&o=sin codificar, se corta ahí como otro parámetro.
Convierte a JSON para comprobar la forma de los arrays y las claves, y mira los valores codificados con la herramienta de codificar / decodificar URL para ver su significado original, y detectarás estas discrepancias pronto.
Resultados reales de la conversión
Este es el resultado de introducir la siguiente URL en la herramienta de parámetros de URL a JSON.
https://example.com/?utm_source=news&utm_medium=email&tag=a&tag=b&q=%E6%9D%B1%E4%BA%AC&empty=&flag
{
"utm_source": "news",
"utm_medium": "email",
"tag": ["a", "b"],
"q": "東京",
"empty": "",
"flag": ""
}
- Los valores se decodifican:
q=%E6%9D%B1%E4%BA%ACse muestra como"東京". - Las claves con el mismo nombre se convierten en un arreglo:
tag=a&tag=bes["a", "b"]. - Una clave con valor vacío y una clave sin
=se convierten ambas en una cadena vacía:empty=yflagno se distinguen. - Todos los valores son cadenas:
page=2pasa a"2", no al número2. - La notación con corchetes como
a[]=1&a[]=2no se expande: la clave sigue siendo"a[]"y el valor es un arreglo.b[x]=3también es"b[x]": "3". Si quiere leerlo como un objeto anidado, compárelo con la interpretación del framework receptor. - Puede introducir una URL completa, todo lo que sigue a
?o solo una parte de consulta comoa=1&a=2.
Resumen
Los parámetros de URL pueden cambiar la medición y el comportamiento de la API con una pequeña errata. En lugar de mirar fijamente una URL larga, descomponerla en JSON mejora la precisión de tu revisión.
Preguntas frecuentes
¿Cómo se manejan las URLs con claves duplicadas?
Cuando la misma clave aparece varias veces, como tag=security&tag=api, la conversión a JSON la muestra como un arreglo. Esto facilita detectar un desajuste donde la API espera un tag=security,api separado por comas pero recibe varios parámetros. Confirma qué formato espera la especificación.
¿Qué debo vigilar con los parámetros UTM?
Los valores de utm_source, utm_medium y utm_campaign se convierten directamente en tus resultados de analítica. Las mayúsculas o grafías inconsistentes (p. ej. Twitter frente a twitter) se cuentan como campañas separadas. Convierte a JSON antes de publicar para confirmar que los valores siguen tu convención de nombres.
Los valores están codificados como %20 y no puedo leerlos.
Los valores de los parámetros de URL se codifican en porcentaje cuando contienen caracteres reservados. %20 es un espacio y %2F es una barra. Decodifícalos con el Codificador y decodificador de URL para confirmar el texto original.
¿Por qué un espacio aparece como +?
En una cadena de consulta, la especificación application/x-www-form-urlencoded puede codificar un espacio como +. La ruta y la codificación según RFC 3986 usan %20. Ambos representan un espacio, pero si no se tiene en cuenta la diferencia al decodificar, el + se queda tal cual, así que compruébalo según el sistema que maneja el valor.
