Primero haz que el JSON sea legible

Las respuestas de API, los webhooks, los logs y los archivos de configuración suelen usar JSON.
Pero muchas veces llega minificado en una sola línea, con estructuras profundas o cadenas escapadas.

Formatear y validar JSON: cómo revisar respuestas de API con seguridad

Formatearlo antes de depurar ayuda a ver la estructura real y evita confundir objetos, arreglos y propiedades anidadas.

Por ejemplo, supón que llega esta respuesta de una sola línea:

{"id":42,"name":"Alice","roles":["admin","editor"],"profile":{"city":"Tokyo"}}

Al formatearla, el anidamiento y los arreglos quedan claros de un vistazo:

{
  "id": 42,
  "name": "Alice",
  "roles": ["admin", "editor"],
  "profile": {
    "city": "Tokyo"
  }
}

Qué revisar después de formatear

Anidamiento

El JSON formateado muestra con claridad a qué objeto pertenece cada campo.
Esto es útil cuando necesitas confirmar rutas como user.profile.name o revisar listas de objetos.

Tipos de valores

"123" es una cadena, mientras que 123 es un número.
"true" no es lo mismo que true, y null no equivale a una cadena vacía.
Detectar estas diferencias evita errores de validación e integración.

Errores de sintaxis

Comas sobrantes, llaves sin cerrar y claves sin comillas son errores comunes.
Un formateador que parsea el contenido permite encontrar el problema antes de usar esos datos en la aplicación.

El ejemplo siguiente tiene dos elementos no válidos como JSON:

{
  "name": "Alice",
  "tags": ["a", "b",],   // coma sobrante
  age: 30                 // la clave no lleva comillas
}

JSON no permite comas sobrantes, comentarios ni claves sin comillas. Suelen colarse al copiar un objeto escrito a mano o un objeto literal de JavaScript, así que confirma primero que el contenido se parsea en un formateador.

Usos habituales

  • Depurar APIs: Pega una respuesta del panel Network o de curl y revisa sus campos.
  • Analizar logs: Convierte logs estructurados de una línea en un formato fácil de leer.
  • Preparar ejemplos: Limpia JSON para documentación, pruebas o reportes de errores.
  • Crear esquemas: Usa una muestra clara para generar tipos TypeScript, esquemas Zod u OpenAPI.

Flujo de trabajo con DevToolKits

El formateador JSON permite formatear y validar JSON directamente en el navegador.
Después puedes continuar con herramientas relacionadas:

Formatear JSON parece un paso pequeño, pero suele ordenar todo el flujo de depuración.

Preguntas frecuentes

¿Puedo usar comentarios o comas finales en JSON?

El JSON estándar no permite ni comentarios ni comas finales. Esas son características de extensiones como JSON5 o JSONC, que algunas herramientas de configuración soportan por su cuenta. Para datos intercambiados con APIs, confirma que sea JSON estándar válido en un formateador.

¿Es seguro pegar JSON con datos sensibles en una herramienta externa?

Es mejor evitar enviar respuestas con claves de API o datos personales a un servicio cuyo procesamiento es opaco. El formateador JSON procesa todo en tu navegador y nunca envía la entrada a un servidor, así que es seguro para inspeccionar datos sensibles.

¿Qué hago después de formatear?

Una vez clara la estructura, puedes derivar tipos, validación o especificaciones de API según necesites: generación de tipos TypeScript para tipos, generación de esquema Zod para comprobaciones en tiempo de ejecución y generación de OpenAPI para compartir la especificación.