JSON
Formato de texto para el intercambio de datos entre sistemas, escrito en pares de clave y valor y adoptado como estándar por la mayoría de las API de la web.
También conocido como: qué es json · archivo json · formato json · ejemplo de json
Prueba CRPRO gratis por 7 díasEl JSON (JavaScript Object Notation) es un formato de texto para el intercambio de datos entre sistemas, escrito en pares de clave y valor. Es lo que prácticamente toda API moderna devuelve y lo que casi todo webhook entrega en tu puerta.
La estructura
{
"evento": "mensaje_recibido",
"contacto": {
"nombre": "Ana Souza",
"telefono": "5531999998888"
},
"etiquetas": ["lead caliente", "instagram"],
"respondida": false
}
Las llaves {} guardan objetos; los corchetes [] guardan listas; el texto va entre comillas dobles; los números, true, false y null van sin comillas. Los objetos pueden contener otros objetos — esa capacidad de anidar es lo que el CSV no tiene.
JSON o CSV
| JSON | CSV | |
|---|---|---|
| Estructura | anidada, jerárquica | tabla plana |
| Tipos | texto, número, booleano, nulo | todo es texto |
| Lectura humana | razonable | buena |
| Uso típico | API, webhook, configuración | importación y exportación de listas |
Un contacto con tres teléfonos y cinco etiquetas cabe naturalmente en JSON; en CSV, se vuelve columna repetida o campo con separador dentro del campo.
Los errores que rompen un JSON
Una coma sobrante antes de cerrar una llave o corchete, comillas simples en vez de dobles, un comentario (JSON no lo permite) y una clave sin comillas. Un carácter equivocado invalida el archivo entero — no existe "medio JSON". Antes de abrir un ticket con el proveedor, pega el contenido en un validador.
JSON válido no significa dato correcto
El formato garantiza sintaxis, no contenido. Un teléfono sin código de país, una fecha en formato local donde se esperaba ISO 8601 (2026-08-01T14:30:00Z) y un campo obligatorio ausente pasan la validación de JSON y rompen la integración. Quien define qué es válido es la documentación de la API, no el intérprete del formato.
Preguntas frecuentes
¿Qué es un archivo JSON?
Es un archivo de texto que organiza datos en pares de clave y valor, legible tanto por personas como por máquinas. Permite estructuras anidadas, como un contacto que contiene una lista de etiquetas dentro. Es el formato más usado hoy para el intercambio de datos entre sistemas.
¿Para qué sirve el JSON?
Sirve para que dos sistemas intercambien datos con estructura definida: la respuesta de una API, el cuerpo de un webhook, un archivo de configuración. Se impuso porque es simple de leer, liviano de transferir y compatible con cualquier lenguaje de programación. Quien integra sistemas convive con JSON a diario.
¿Cómo abrir un archivo JSON?
Cualquier editor de texto lo abre, incluido el bloc de notas. Para leerlo cómodamente, usa un visor que formatee y colapse los bloques, como un editor de código o una extensión de navegador. Evita abrirlo en Word, que puede insertar caracteres y corromper el archivo.
¿Cuál es la diferencia entre JSON y XML?
Los dos representan datos estructurados, pero XML usa etiquetas de apertura y cierre y ocupa bastante más espacio. JSON es más ligero y más directo de convertir en objeto en la mayoría de los lenguajes. Las API nuevas nacen en JSON; XML sobrevive en sistemas más antiguos e integraciones fiscales.
Páginas relacionadas
Términos relacionados en el glosario
API REST
Estilo de arquitectura de API que usa los métodos y códigos del propio HTTP para operar sobre recursos identificados por URL, sin guardar estado entre llamadas.
CSV
Archivo de texto plano en el que cada línea representa un registro y los campos se separan con un carácter, casi siempre coma o punto y coma.
API
Interfaz que permite que dos sistemas intercambien datos y comandos entre sí, sin que uno necesite conocer el funcionamiento interno del otro.