# Ejemplos de JSON comentados — Torus Academy

Cuatro ejemplos reales de JSON, del más sencillo al más complejo, con una
explicación en texto antes de cada uno. Están pensados para leerse con
NVDA, línea por línea, usando la flecha abajo dentro del bloque de código.

Se referencian desde la lección «El formulario con casillas: qué es
JSON» (módulo 1.2) y desde el módulo 3.1 («JSON y Webhooks»), donde se
trabajan con más profundidad los ejemplos 3 y 4.

## Ejemplo 1 — Un dato de cliente (objeto simple)

Tres casillas: nombre, teléfono y si la llamada es urgente.

```json
{
  "nombre": "Ana García",
  "telefono": "600000000",
  "urgente": true
}
```

Lectura: la clave "nombre" tiene el valor de texto "Ana García"; la
clave "telefono" tiene el valor de texto "600000000" (entre comillas,
porque se trata como texto y no como número, para no perder ceros a la
izquierda ni permitir operaciones aritméticas con él); la clave
"urgente" tiene el valor booleano `true`, sin comillas.

## Ejemplo 2 — Una lista de servicios (array)

Un negocio que ofrece varios servicios.

```json
{
  "negocio": "Fontanería Ejemplo",
  "servicios": ["fontanería", "calefacción", "urgencias 24 horas"]
}
```

Lectura: la clave "servicios" no tiene un único valor, sino una lista
ordenada de tres valores de texto, delimitada por corchetes `[ ]`. Esa
lista se llama array. Cada elemento del array está separado del
siguiente por una coma.

## Ejemplo 3 — Un Webhook de confirmación de cita (objeto anidado)

Así podría llegar, en un Webhook real, la confirmación de una cita
reservada por el agente telefónico a través de Tool Calling.

```json
{
  "tipo_evento": "cita_confirmada",
  "cliente": {
    "nombre": "Juan Pérez",
    "telefono": "600111222"
  },
  "cita": {
    "fecha": "2026-09-15",
    "hora": "10:00",
    "servicio": "revisión de calefacción"
  }
}
```

Lectura: aquí hay un objeto principal con tres casillas: "tipo_evento",
"cliente" y "cita". Las casillas "cliente" y "cita" no son un simple
texto, sino que contienen, cada una, otro objeto completo con sus
propias casillas (llaves dentro de llaves). Esto se llama anidación:
un objeto anidado dentro de otro. Para leerlo con NVDA sin perderse,
conviene avanzar línea por línea y fijarse en la indentación (los
espacios al principio de cada línea), que indica qué casillas
pertenecen a qué objeto.

## Ejemplo 4 — Varias citas en una sola respuesta (array de objetos)

Así podría responder una automatización de n8n o Make al consultar
todas las citas de un día, combinando array y objeto anidado.

```json
{
  "fecha_consultada": "2026-09-15",
  "citas": [
    {
      "hora": "10:00",
      "cliente": "Juan Pérez",
      "servicio": "revisión de calefacción"
    },
    {
      "hora": "12:30",
      "cliente": "Ana García",
      "servicio": "urgencia de fontanería"
    }
  ]
}
```

Lectura: la clave "citas" contiene un array (corchetes `[ ]`), y cada
elemento de ese array es, a su vez, un objeto completo (llaves `{ }`)
con sus propias casillas "hora", "cliente" y "servicio". Esta
combinación —un array de objetos— es exactamente el formato en el que
la mayoría de plataformas de automatización devuelven listas de
resultados (por ejemplo, una lista de citas, de clientes o de
mensajes).

## Cómo practicar la lectura con NVDA

1. Copia cualquiera de estos bloques de código en un editor de texto
   simple (por ejemplo, el Bloc de notas de Windows).
2. Recorre el texto línea por línea con la flecha abajo.
3. En cada línea, identifica primero la clave (antes de los dos
   puntos) y después el valor (después de los dos puntos).
4. Cuando encuentres una llave o un corchete de apertura, anota
   mentalmente «empieza un objeto» o «empieza una lista»; cuando
   encuentres el de cierre, «termina».

No hace falta leer en voz alta cada símbolo de puntuación para
entender el contenido: basta con reconocer el patrón.

---

Recurso de Torus Academy. Última actualización: 30 de agosto de 2026.