Todo el mundo ha perdido una tarde por culpa de una coma de más en un JSON. La solución no es tener más cuidado, es automatizar la validación en cada paso: en tu editor (pre-commit hooks), en CI y — cuando no tienes nada más a mano — en un formateador online que valide mientras escribe.
El flujo típico
- Pegas la respuesta de la API en el formateador de JSON.
- Pulsas "Validar": te dice si el documento es correcto y, si no, la línea y columna exactas del error.
- Con "Formatear" lo ordenas a 2 o 4 espacios.
- Cuando vas a subir algo a un
.jsonde producción, usas "Minificar" para quitar espacios y ahorrar bytes.
Minificar: cuánto peso ahorras
Los espacios, tabulaciones y saltos de línea suelen suponer un 15–30 % del peso de un JSON. El formateador te muestra los bytes ahorrados en cada minificación. Si quieres aún más, combina la minificación con nombres de clave cortos y sin CamelCase inflado.
Errores frecuentes y cómo se ven
- Coma después del último elemento – el clásico de Git.
- Comillas dobles – JSON no acepta comillas simples; es el error nº 2.
- Números con ceros a la izquierda –
01no es JSON válido. - Trailing decimal –
1.tampoco.
JSON ↔ CSV ↔ YAML
Del mismo editor también puedes convertir en ambas direcciones: JSON a CSV (array de objetos → tabla) y JSON a YAML (para configs de Docker Compose, Ansible o Kubernetes). Cada herramienta respeta la sintaxis del destino y te avisa si algo no es convertible.
Cuando el JSON es grande: árbol, Schema y tipos
Un JSON anidado de varios cientos de líneas es difícil de leer en texto plano. El visor en árbol lo despliega como una estructura colapsable para que navegues directo a la clave que buscas, sin hacer scroll infinito.
Si el JSON es la respuesta de una API que vas a consumir en TypeScript, no escribas el tipo a mano: pega el JSON en el conversor a TypeScript y genera las interface automáticamente, con los tipos anidados resueltos. Y si necesitas documentar o validar la forma del documento (por ejemplo, para un contrato de API), el generador de JSON Schema construye el $schema a partir de un ejemplo real.
La regla de oro: valida antes de guardar, minifica antes de publicar.
Preguntas frecuentes
¿Se pueden poner comentarios en JSON?
No, el estándar no los admite. Si necesitas comentarios en un archivo de configuración, usa formatos como YAML o JSON5, o una clave de texto reservada para notas.
¿Cuál es la diferencia entre null y un campo ausente?
null indica que el campo existe y no tiene valor; ausente significa que no está definido. Algunas APIs tratan ambos casos de forma distinta, así que conviene documentar cuál esperas.
¿Se garantiza el orden de las claves?
La especificación define los objetos como colecciones sin orden. En la práctica, la mayoría de parsers conservan el orden de aparición, pero no debes depender de ello.
¿Cuál es el tamaño máximo de un JSON?
El estándar no impone límite. Lo marcan el servidor, el navegador y la memoria disponible. Para volúmenes grandes, considera JSON Lines (un objeto por línea) o paginación.