Query Params a JSON
Pega una URL o una cadena de consulta y léela como JSON: claves repetidas, codificación por porcentajes y notación de corchetes incluidas.
Cómo Usar el Convertidor de Query Params a JSON
- Pega una URL completa, un fragmento que empiece por ? o una cadena de consulta suelta como q=hola&pagina=2 en el cuadro de entrada.
- Deja activada la opción "Agrupar claves repetidas en arrays" para que ?etiqueta=a&etiqueta=b se convierta en un array en lugar de perder el primer valor.
- Mantén "Decodificar los valores" para leer texto normal, o desactívalo cuando necesites ver los caracteres codificados exactamente como viajaron.
- Activa "Expandir la notación de corchetes" si tu API usa claves como filtros[estado]=abierto o etiquetas[]=json, y pasarán a ser objetos y arrays anidados.
- Pulsa "Convertir a JSON", revisa la tabla de desglose de la URL y copia el JSON para tu prueba, tu informe de error o tu cliente de API.
¿Qué Es un Convertidor de Query Params a JSON?
La cadena de consulta es la parte de una URL que va después del signo de interrogación: una lista plana de pares clave=valor unidos por ampersands. Es compacta y cómoda para el navegador, pero se vuelve ilegible en cuanto pasa de unos pocos parámetros; un enlace con etiquetas UTM, una búsqueda filtrada o una redirección de OAuth llegan sin esfuerzo a trescientos caracteres en una sola línea. Esta herramienta analiza esa cadena con el propio motor URLSearchParams del navegador y la imprime como JSON indentado, con cada parámetro en su propia línea.
Tres detalles separan un divisor de juguete de algo en lo que puedes confiar mientras depuras. Las claves repetidas existen de verdad: ?a=1&a=2 es válido y significa los dos valores, así que aquí se agrupan en un array en vez de descartar uno. La codificación por porcentajes también es real: %20, + y %C3%A9 necesitan decodificarse para que el valor tenga sentido, y un escape roto se avisa en lugar de tragárselo en silencio. Por último, muchos frameworks meten la estructura dentro de la propia clave, de modo que filtros[estado]=abierto o etiquetas[]=json pueden volver a convertirse en objetos y arrays anidados cuando lo pides.
¿Trabajas con texto codificado en general? El codificador y decodificador de URL se ocupa de valores sueltos en ambos sentidos. Si tus datos son tabulares, el convertidor de CSV a JSON transforma exportaciones de hojas de cálculo en el mismo tipo de JSON, y el formateador de JSON deja presentable lo que salga de aquí.
Preguntas Frecuentes (FAQ)
¿Cómo convierto la cadena de consulta de una URL a JSON?
Pega la URL o la cadena de consulta en el cuadro de arriba y pulsa "Convertir a JSON". El análisis se hace en tu navegador con URLSearchParams, así que el resultado coincide con lo que vería un servidor o una llamada fetch().
¿Qué ocurre con parámetros repetidos como ?a=1&a=2?
Con "Agrupar claves repetidas en arrays" activado obtienes {"a":["1","2"]} y conservas los dos valores. Si lo desactivas, gana la última aparición, que es como leen un valor único algunos frameworks.
¿Puedo pegar una URL entera en lugar de solo la cadena de consulta?
Sí. Si la entrada se analiza como URL, solo se convierte su parte de consulta y una tabla muestra protocolo, host, puerto, ruta y fragmento. También funciona una cadena suelta, con o sin ? o # al principio.
¿Cómo convierto notación de corchetes como a[b]=1 en JSON anidado?
Activa "Expandir la notación de corchetes". Entonces a[b]=1 pasa a {"a":{"b":"1"}}, a[]=1&a[]=2 pasa a {"a":["1","2"]} y las claves más profundas como usuario[idiomas][] se anidan tanto como haga falta.
¿Conviene dejar activada la decodificación de valores?
Normalmente sí, porque %20 se convierte en un espacio y %C3%A9 en é, que es lo que realmente recibió la aplicación. Desactívala cuando persigas un error de doble codificación y necesites ver los caracteres literales que se transmitieron.
¿Qué significa el error de escape de porcentaje roto?
Significa que un % no va seguido de dos dígitos hexadecimales válidos; el caso clásico es un %E2 truncado, normalmente porque la URL se cortó. Repara la cadena o desactiva la decodificación para inspeccionar los pares tal cual.
¿Funciona con fragmentos como #access_token=abc?
Sí. Cuando la entrada no es una URL completa se elimina el # inicial y el resto se analiza como cadena de consulta, que es justo como viajan los tokens de OAuth de flujo implícito y las rutas de una SPA.
¿Se envía a algún sitio la URL que pego?
No. Todo se ejecuta en el cliente con JavaScript y nada se registra ni se sube. Aquí importa especialmente, porque las cadenas de consulta suelen llevar identificadores de sesión, enlaces firmados y tokens de acceso.
Consejos para Analizar Cadenas de Consulta
- Tip 1: Convierte dos veces, una con la decodificación activada y otra sin ella. Si las diferencias van más allá de los escapes, algo de tu stack está codificando el valor por segunda vez.
- Tip 2: La expansión de corchetes imita cómo serializan los formularios anidados Rails, PHP y qs, así que es la vía más rápida para ver qué recibió de verdad tu API desde un panel de filtros.
- Tip 3: El número de parámetros bajo el resultado es una comprobación rápida: si es menor de lo esperado, un & suelto o un valor sin codificar se está comiendo pares.
- Tip 4: Ten dos vecinos a mano: el codificador y decodificador de URL para arreglar un valor roto, y el convertidor de CSV a JSON cuando esos mismos datos lleguen como exportación de hoja de cálculo.