JSON explicado para no programadores: formatea y valida sin miedo

El idioma en el que hablan tus herramientas

Si alguna vez has abierto un flujo de n8n, has mirado la respuesta de una API o has copiado la configuración de una integración, te habrás encontrado con un bloque de texto lleno de llaves, comillas y dos puntos. Parece pensado para máquinas, y lo está. Pero entenderlo no requiere saber programar, y te ahorra muchas horas de “no sé por qué esto no funciona”.

JSON (JavaScript Object Notation) es un formato de texto para guardar e intercambiar datos estructurados mediante pares de nombre y valor. Es el estándar de facto con el que se comunican las APIs, las plataformas de automatización y los modelos de IA cuando necesitan devolver datos ordenados en lugar de texto libre.

Por qué JSON importa si automatizas o usas IA

En una PYME que empieza a automatizar, JSON aparece en todas partes:

• APIs: cuando tu CRM, tu tienda online o tu programa de facturación envían datos a otra aplicación, casi siempre lo hacen en JSON.
• Plataformas de automatización: en n8n, Make o Zapier, cada paso de un flujo recibe y entrega datos en JSON. Si eliges plataforma, te ayudará nuestra comparativa n8n vs Make vs Zapier.
• Respuestas estructuradas de IA: cuando pides a un modelo que extraiga datos de una factura o clasifique un correo, lo habitual es que responda en JSON para que el siguiente paso del flujo pueda leerlo sin ambigüedades. Lo contamos en agentes de IA con datos estructurados.

Saber leerlo te permite revisar qué datos están pasando realmente entre tus sistemas, detectar un campo vacío o un formato incorrecto y explicar el problema a quien mantenga la integración.

Cómo es un JSON por dentro

Un ejemplo sencillo, un cliente:

{
  "nombre": "Ferretería López",
  "cif": "B12345678",
  "activo": true,
  "facturas_pendientes": 2,
  "contactos": ["compras@ejemplo.com", "gerencia@ejemplo.com"],
  "direccion": {
    "ciudad": "Alcobendas",
    "cp": "28100"
  }
}

Las reglas básicas son pocas:

• Objetos entre llaves { }, con pares "nombre": valor separados por comas.
• Listas entre corchetes [ ].
• Textos siempre entre comillas dobles. Los números, true, false y null van sin comillas.
• Los nombres de los campos también van entre comillas dobles.

Los errores que rompen un JSON

Un JSON es estricto: un solo carácter fuera de sitio hace que el sistema que lo recibe lo rechace entero. Los fallos más habituales son:

1. Coma final después del último elemento: "cp": "28100",}.
2. Comillas simples en lugar de dobles: 'nombre'.
3. Llaves o corchetes sin cerrar, sobre todo al copiar un fragmento de un JSON más grande.
4. Comentarios: JSON no admite // ni /* */.
5. Comillas tipográficas (“ ”) que se cuelan al pegar desde un procesador de textos o un chat.

Tres herramientas gratuitas para trabajar con JSON

En Rakaty tenemos tres utilidades que funcionan directamente en tu navegador: pegas el contenido y el procesamiento se hace en tu propio equipo.

Formateador JSON: de una línea ilegible a algo que se entiende

Las APIs suelen devolver el JSON comprimido en una sola línea. El formateador JSON lo convierte en una estructura indentada y legible.

1. Pega tu JSON en el cuadro de entrada.
2. Elige la indentación: 2 espacios, 4 espacios o tabulador.
3. Pulsa Formatear para verlo ordenado, o Minificar si quieres el proceso contrario (todo en una línea, para ocupar menos).
4. Usa Copiar resultado para llevártelo a tu flujo o documento.

Si el texto no es un JSON válido, la herramienta te avisa en lugar de devolver un resultado a medias.

Validador JSON: encuentra el error exacto

Cuando una integración falla con un mensaje críptico, el validador JSON te dice si el contenido es correcto y, si no lo es, muestra el mensaje de error y, cuando el navegador lo indica, la línea y la columna donde está el problema. Si es válido, te confirma el tipo de dato principal y el tamaño en caracteres.

Es la forma más rápida de saber si el fallo está en el dato o en otra parte del flujo.

Conversor JSON a CSV: de los datos a la hoja de cálculo

Muchas veces el destino final de los datos es Excel o Google Sheets. El conversor JSON a CSV transforma una lista de objetos JSON en una tabla CSV, con una columna por campo, y también funciona en sentido contrario (de CSV a JSON). Después copias el resultado y lo pegas o guardas como archivo.

Ten en cuenta que trabaja con CSV separado por comas: si tu hoja usa punto y coma, conviene revisarlo antes de convertir.

Buenas prácticas en el día a día

• Valida antes de culpar a la integración: muchas incidencias son un JSON mal formado que alguien editó a mano.
• No edites JSON en Word ni en el correo: las comillas tipográficas lo rompen. Usa un editor de texto plano o las propias herramientas.
• Cuidado con los datos personales: aunque estas herramientas procesan el contenido en tu navegador, evita compartir JSON con datos de clientes por canales no seguros. Lo tratamos en RGPD e IA con datos de clientes.
• Pide a la IA el formato exacto: si un modelo debe devolver JSON, dale un ejemplo con los campos que esperas y valida siempre su salida antes de usarla.

Preguntas frecuentes

¿Necesito saber programar para usar JSON?

No. Para leerlo, revisarlo y detectar errores basta con conocer las cuatro reglas básicas de este artículo. Escribir integraciones complejas sí requiere más conocimientos, pero entender qué datos circulan está al alcance de cualquiera.

¿Qué diferencia hay entre formatear y validar?

Formatear cambia la presentación (sangrías y saltos de línea) sin tocar los datos. Validar comprueba si la sintaxis es correcta. El formateador también falla con un JSON inválido, pero el validador está pensado para decirte dónde está el error.

¿Por qué la IA a veces devuelve un JSON que no funciona?

Porque los modelos generan texto y pueden añadir una coma de más, un comentario o una frase antes del JSON. Por eso en una automatización seria la salida del modelo se valida siempre antes de pasarla al siguiente paso, y se reintenta o se avisa si no es correcta.

¿El conversor sirve para archivos muy grandes?

Funciona en tu navegador, así que depende de la memoria de tu equipo. Para volúmenes grandes y recurrentes tiene más sentido automatizar la conversión dentro del propio flujo.

Conclusión

JSON es el formato en el que se entienden tus herramientas, tus integraciones y los modelos de IA. Perderle el miedo te da autonomía para revisar qué está pasando en tus automatizaciones. Prueba el formateador, el validador y el conversor a CSV, gratis y sin registro.

Y si quieres que tus sistemas se pasen los datos solos, sin copiar y pegar, en Rakaty diseñamos esas integraciones contigo. Cuéntanos qué necesitas.