El Lenguaje de las Automatizaciones

Una API (Interfaz de Programación de Aplicaciones) es el protocolo que permite que dos aplicaciones conversen. Sin APIs, las aplicaciones son islas aisladas.

Lo importante no es la analogía en sí, sino qué contiene una petición. Toda petición de API tiene 4 partes, y un buen automatizador las conoce:

• URL (dirección): a quién le pides ("al camarero del restaurante X").
• Método (la acción): GET (leer), POST (crear), PUT (actualizar), DELETE (borrar). Es el "verbo" de tu pedido.
• Headers (cabeceras): contexto de la petición (ej. Content-Type: application/json = "te mando JSON"; Authorization = "soy quién digo ser").
• Body (cuerpo): los datos que envías (ej. los ingredientes del pedido).

A diferencia de una API donde tú preguntas "¿está lista mi comida?", un Webhook es un mensaje proactivo: "¡Oye, aquí tienes un nuevo dato!".

La diferencia clave es quién inicia la conversación:

• API (Polling): TU sistema pregunta cada X segundos "¿hay algo nuevo?". Consume recursos aunque no haya cambios.
• Webhook: el otro sistema te avisa SOLO cuando pasa algo. Eficiente y en tiempo real.

// Ejemplo de flujo real:
[Sitio Web] --(evento: Nuevo Lead)--> [Webhook URL de n8n]
[n8n] --(acción: Telegram API)--> [Telegram del Cliente]
[n8n] --(acción: guardar en BD)--> [PostgreSQL]

Las máquinas no hablan español, hablan JSON (JavaScript Object Notation). Es una estructura de llave-valor, y n8n la usa en casi todo.

Los tipos de datos que encontrarás (y que debes reconocer para no equivocarte al mapear):

• String (texto): "Gabriel"
• Number (número): 2026
• Boolean (verdadero/falso): true
• Null (vacío/ausente): null
• Array (lista): [ "a", "b" ]
• Object (objeto anidado): { "cliente": { ... } }

{
  "nombre": "Gabriel",
  "servicio": "Bot WhatsApp",
  "año": 2026,
  "activo": true,
  "etiquetas": ["n8n", "IA"],
  "cliente": {
    "nombre": "Ana",
    "plan": "Diagnóstico"
  }
}

Si n8n recibe un JSON de un sitio web, pero la API de Telegram espera un formato diferente, n8n no "conecta" las cosas mágicamente: traduce los datos de un formato a otro usando expresiones.

Ese es el corazón de la automatización: tomar la salida de un sistema, transformarla, y entregársela a otro en el formato que espera. Si dominas esto, dominas n8n.

Ejercicio: identificar las partes de una petición

Toma esta petición y responde (mentalmente o en un cuaderno):

POST https://api.example.com/leads
Headers: Content-Type: application/json
Body: { "nombre": "Carlos", "monto": 250000 }

• El método es POST → estás creando un recurso, no leyendo.
• La URL apunta al recurso /leads → estás creando un lead.
• El body es JSON con dos campos: nombre (string) y monto (número).
• El header dice que el body va en JSON — sin eso, el servidor no lo interpreta.

Si lograste identificar esas 4 partes sin ayuda, ya leíste una petición real de API. Eso es lo que n8n hace por ti con sus nodos, pero ahora sabes QUÉ está pasando por debajo.

• Puedo explicar cliente, API y servidor con la analogía del camarero
• Nombro las 4 partes de una petición: URL, método, headers, body
• Distingo API (pregunta) vs Webhook (aviso proactivo)
• Reconozco los tipos de JSON: string, number, boolean, null, array, object
• Entiendo que n8n traduce datos entre formatos