Cómo extraer valores de un JSON con una ruta

Para qué sirve y qué puedes consultar

Esta herramienta permite consultar texto JSON mediante una expresión de ruta y localizar los valores que te interesan sin recorrer manualmente toda la estructura. Puede resultar útil para revisar respuestas de APIs, comprobar la forma de un documento o aislar propiedades concretas antes de analizarlas en detalle. La entrada JSON y la ruta son textos independientes y opcionales: si uno de ellos está vacío o contiene solo espacios, la consulta termina correctamente, pero no encuentra coincidencias.

Cómo consultar un JSON paso a paso

1. Prepara un JSON válido como texto. Por ejemplo, puedes usar un objeto con propiedades anidadas y listas. Comprueba que las comillas, llaves, corchetes y comas estén correctamente colocados.

2. Escribe la ruta que quieres consultar en el campo correspondiente. Para propiedades de objetos, usa segmentos separados por puntos, como cliente.nombre. También puedes emplear un comodín para recorrer valores de objetos o elementos de listas, y expresiones entre corchetes para seleccionar índices concretos o rangos de índices.

3. Ejecuta la consulta con el JSON y la ruta completos. Cuando la entrada es válida y la extracción termina normalmente, revisa los valores encontrados, el número de coincidencias y la ruta proporcionada. Si la ruta no coincide con ningún elemento, la consulta puede ser correcta y devolver cero coincidencias.

4. Si el resultado indica un fallo, revisa primero el JSON: cuando tanto la entrada como la ruta contienen texto no vacío, un JSON no válido impide una extracción correcta. Después comprueba la sintaxis de la ruta, especialmente los índices, los rangos y los corchetes. Algunas rutas mal formadas pueden no producir la estructura habitual de resultados, por lo que conviene corregirlas antes de volver a ejecutar la consulta.

5. Para comparar varias partes de un documento, cambia solo la ruta y conserva el mismo JSON. Así podrás comprobar qué propiedades o posiciones se encuentran y distinguir entre una ruta sin coincidencias y un documento que no puede procesarse.

Cómo leer el resultado y sus límites

Un resultado correcto incluye los valores localizados, la cantidad de valores encontrados y la ruta que se ha enviado. Una cantidad de cero no significa necesariamente que el JSON sea incorrecto: con un JSON válido, puede indicar simplemente que ningún elemento coincide con la ruta solicitada. En cambio, la entrada vacía o formada solo por espacios se gestiona antes y termina correctamente sin coincidencias.

Interpreta por separado los fallos de formato. Un JSON inválido puede impedir la extracción cuando la entrada y la ruta contienen texto; una ruta mal formada tampoco tiene un comportamiento de error uniforme para todas las sintaxis posibles. Por eso, si no aparece la estructura normal del resultado, simplifica la ruta, revisa los corchetes y confirma que los índices o rangos están bien escritos. La herramienta cubre las formas de ruta descritas, no todas las expresiones posibles de un estándar completo.

Ejemplo práctico

Quieres comprobar qué nombre contiene un objeto JSON anidado antes de utilizar ese dato en otra revisión.

Introduce {"usuario":{"nombre":"Ana"},"activo":true} como JSON, escribe usuario.nombre como ruta y ejecuta la consulta.

La respuesta correcta debe informar de los valores que coinciden, del número de coincidencias y de la ruta proporcionada.

Limitaciones

• No cubre todas las expresiones de un estándar completo de rutas JSON. El JSON inválido puede impedir la extracción y algunas rutas mal formadas pueden no devolver la estructura normal del resultado.

Errores frecuentes

• Causa: se ha usado un JSON con un error de sintaxis o una ruta con corchetes, índices o rangos mal formados. Corrección: valida las llaves, comillas y comas del JSON y prueba una ruta sencilla con puntos antes de volver a añadir comodines o selecciones entre corchetes.

Preguntas frecuentes

¿Puedo consultar propiedades anidadas de un JSON?

Sí, puedes consultar propiedades anidadas separando sus nombres con puntos, y también recorrer valores de objetos o elementos de listas mediante el comodín compatible.

¿Qué significa que aparezcan cero coincidencias?

Sí. Con un JSON válido, una ruta que no encuentra elementos produce un resultado correcto con cero coincidencias; no indica por sí sola que el documento esté mal formado.

¿Un resultado fallido significa siempre que la ruta es incorrecta?

No necesariamente. Si el JSON o la ruta están vacíos o contienen solo espacios, la consulta termina correctamente sin coincidencias. Cuando ambos contienen texto, un JSON inválido puede producir un resultado fallido.