¿Qué es JSON y por qué aparece en casi todas las APIs?

Publicado el 2026-10-20 por frfrand

JSON explicado para principiantes: objetos, listas, cadenas, números, ejemplo real de una API y errores que impiden leerlo correctamente.

JSON es un formato de texto para representar información estructurada que pueden intercambiar programas escritos en lenguajes diferentes. Se llama JavaScript Object Notation, pero sirve también para Python, Java, Go, aplicaciones móviles y prácticamente cualquier entorno moderno.

Si alguna vez abriste una API y encontraste llaves, comillas y dos puntos, probablemente estabas mirando JSON. La sintaxis parece extraña hasta que comprendes que solo describe datos.

Un ejemplo sencillo de una tienda

{
  "id": 42,
  "nombre": "Teclado mecánico",
  "precio": 79.90,
  "disponible": true,
  "categorias": ["accesorios", "teclados"]
}

Las palabras de la izquierda son claves; a la derecha aparece su valor. Las llaves contienen un objeto, los corchetes contienen una lista y las comillas indican texto. No hay ninguna instrucción que se ejecute por escribirlo.

¿Qué tipos de valores existen?

JSON admite cadenas de texto, números, booleanos true y false, el valor null, arrays y objetos. Puedes combinar listas y objetos para representar información más compleja.

No admite funciones, comentarios ni fechas como tipo especial. Una fecha puede transmitirse como texto siguiendo un formato acordado, pero la aplicación debe interpretarla.

¿Por qué las APIs lo usan tanto?

Imagina un frontend en React que necesita mostrar productos guardados en un backend Django. Ambos pueden ponerse de acuerdo para intercambiar una lista JSON. El servidor devuelve datos; el frontend decide cómo dibujarlos.

JSON es frecuente en HTTP, pero no significa que una API esté obligada a utilizarlo. Hay servicios que intercambian XML, datos binarios u otros formatos. HTTP transporta mensajes; JSON describe una posible representación de los datos.

JSON no es una base de datos

Podés conservar un archivo .json en tu disco, pero eso no lo convierte en PostgreSQL. Un motor de base de datos gestiona consultas, transacciones, concurrencia, almacenamiento y otros problemas que el formato no resuelve.

También existen bases de datos que almacenan documentos JSON. Ahí el formato forma parte de cómo se representan los registros, pero el motor sigue siendo otra pieza.

Errores que aparecen constantemente

Usar comillas simples. En JSON estándar, claves y cadenas deben utilizar comillas dobles.

Dejar una coma final. Esto produce una sintaxis inválida: {"nombre":"Ana",}. Algunos lenguajes permiten ese estilo en sus propios objetos, JSON no.

Agregar comentarios. Una línea que empieza con // no es válida dentro de JSON puro, aunque ciertas variantes lo acepten.

Confundir número y texto. 42 no es lo mismo que "42". Y null tampoco equivale a "null".

¿Cómo lo utiliza un programador?

En JavaScript, JSON.parse transforma una cadena JSON válida en un valor del lenguaje; JSON.stringify convierte valores compatibles a texto JSON. En Python podés utilizar el módulo estándar json.

Pero hay un detalle importante: JSON bien escrito no significa dato confiable. Si llega {"admin":true} desde el navegador, el servidor no debería permitir privilegios administrativos solo porque la clave exista y tenga una sintaxis válida.

¿Y en ArduMaker?

Muchas interfaces de API y herramientas de infraestructura intercambian estructuras de datos. Entender JSON ayuda a interpretar respuestas, construir integraciones y diagnosticar errores sin confundir el formato con la operación que ejecuta un servidor.

En resumen: JSON es una gramática para escribir datos. Entender objetos, arrays y tipos de valor te permite comprender muchas respuestas de APIs sin aprender todo un lenguaje de programación.

Fuentes: Especificación JSON, RFC 8259 · Referencia JSON de MDN · Qué es una API.