Format Atlas

Comparar

JSON vs TOML

JSON se usa ampliamente en API e intercambio de datos entre programas. TOML está pensado para configuración de aplicaciones editada por personas, con claves, valores, tablas y listas legibles.

¿Qué formato deberías elegir?

Usa JSON cuando una API o herramienta lo requiera. Considera TOML para configuración mantenida por personas que se beneficie de comentarios y tablas claras, tras comprobar el analizador y su versión.

Adecuado para JSON

API web, archivos de configuración e intercambio de datos

  • Transferir datos estructurados

Adecuado para TOML

Configuración de aplicaciones y herramientas

  • Ajustes legibles con valores estructurados

Información básica

CampoJSONTOML
Extensión.json.toml
Tipo MIMEapplication/jsonapplication/toml
Usos habitualesAPI web, archivos de configuración e intercambio de datosConfiguración de aplicaciones y herramientas
Cómo abrirÁbralo en un editor de texto, IDE o visor compatible con JSON.Ábralo en un editor y consulte la documentación de la aplicación sobre TOML compatible.
Exportar o convertirLas aplicaciones o herramientas de conversión pueden convertirlo a formatos como CSV.Al convertir desde JSON o YAML, compruebe anidación, listas, comillas, fechas y tipos tras analizar.

Elegir según el uso

Transferir datos estructurados

API web, archivos de configuración e intercambio de datos

JSON

Ajustes legibles con valores estructurados

Configuración de aplicaciones y herramientas

TOML

Punto clave 1

JSON está normalizado para intercambiar datos estructurados y su sintaxis estándar no incluye comentarios.

Más sobre las diferencias

Punto clave 2

TOML es un formato de texto para configuración, con tablas y listas pensadas para leerse y editarse fácilmente.

Más sobre las diferencias

Más sobre las diferencias

Elige el formato que admita la aplicación receptora y el flujo de trabajo. Valida el esquema y confirma que fechas, números y listas conservan sus tipos al convertir.

  • JSON es común en API e intercambio interoperable entre máquinas.
  • TOML puede aclarar ajustes mantenidos manualmente, pero no todos los servicios orientados a JSON lo aceptan.
  • Ambos requieren validar el analizador y el esquema cuando la configuración afecta al comportamiento de la aplicación.

Preguntas frecuentes

¿La configuración siempre debería usar TOML en vez de JSON?

No. Usa el formato que exijan las herramientas; TOML puede facilitar ajustes editados por personas, pero muchas API y herramientas requieren JSON.

¿JSON puede incluir comentarios?

JSON estándar no admite comentarios. Si los necesita, use un formato y analizador que los permitan explícitamente.

Más información

Usos y comprobaciones relacionados

Elegir un formato de configuración

Referencias y especificaciones