Tools mentioned in this article
Open the browser-based tool while you read and try the workflow immediately.
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=apiComo 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.
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.