Cómo formatear y validar JSON: guía práctica para principiantes

JSON es un formato de texto utilizado para intercambiar datos entre navegadores, servidores, aplicaciones y archivos de configuración. Es legible, pero también estricto: una comilla incorrecta, una coma final o una llave sin cerrar puede impedir que todo el documento se procese.

Las estructuras básicas de JSON

Un objeto se escribe entre llaves y contiene pares de clave y valor. Una lista se escribe entre corchetes. Las claves deben ir entre comillas dobles. Los valores pueden ser texto, números, true, false, null, objetos o listas.

{
  "name": "ToolBlur",
  "active": true,
  "languages": ["en", "ar", "es", "de"],
  "stats": {
    "tools": 100,
    "free": true
  }
}

JSON no admite comentarios, comillas simples ni valores como undefined. Tampoco permite una coma después del último elemento. Estas diferencias son importantes cuando copias un objeto desde JavaScript.

Qué significa formatear JSON

Formatear añade saltos de línea e indentación sin cambiar los datos. Esto facilita leer objetos anidados y revisar cambios. Minificar hace lo contrario: elimina espacios innecesarios para producir una representación compacta. Ambos documentos pueden contener exactamente la misma información.

Puedes pegar el contenido en el Formateador JSON de ToolBlur. El análisis ocurre en el navegador. Si los datos incluyen tokens, credenciales o información personal, elimina lo que no sea necesario antes de compartir la salida con otra persona.

Errores frecuentes y cómo localizarlos

• Coma final: elimina la coma situada antes de una llave o corchete de cierre.
• Comillas simples: sustituye 'valor' por "valor".
• Clave sin comillas: escribe "name", no name.
• Caracteres de control: usa secuencias como \n dentro de una cadena.
• Llaves desequilibradas: comprueba que cada apertura tenga su cierre.

Cuando el mensaje indica una posición, revisa también los caracteres anteriores. Un error temprano puede hacer que el analizador señale el lugar donde finalmente dejó de entender el documento.

Sintaxis válida no significa datos correctos

Un documento puede ser JSON válido y aun así utilizar campos equivocados. Por ejemplo, una API puede exigir que age sea un número positivo, aunque "age": "unknown" sea sintácticamente válido. JSON Schema permite describir campos requeridos, tipos, límites y patrones. La validación de sintaxis y la validación de esquema resuelven problemas distintos.

Flujo seguro para trabajar con una API

1. Guarda una copia del valor original.
2. Comprueba primero la sintaxis.
3. Formatea para revisar nombres, niveles y tipos.
4. Compara el documento con la documentación o el esquema de la API.
5. Prueba en un entorno de desarrollo antes de modificar producción.

Preguntas frecuentes

¿El orden de las claves importa?

Normalmente no debe utilizarse como significado. Una aplicación correcta accede a los valores por el nombre de la clave.

¿JSON admite fechas?

No existe un tipo fecha propio. Se suele usar una cadena ISO 8601, pero emisor y receptor deben acordar formato y zona horaria.

¿Puedo guardar números muy grandes?

El formato los admite, pero algunos entornos pierden precisión. Los identificadores numéricos grandes suelen transportarse como texto.