Módulo 02

Los Cuatro Verbos del Arquitecto

Métodos HTTP: las acciones fundamentales que un sistema puede ejecutar sobre otro. La base de toda integración.

Fase 1 · Fundamentos ~40 min Guía práctica
1

¿Qué es un Método HTTP?

En el Módulo 01 aprendiste que una API es un "camarero". El método HTTP es lo que le pides al camarero: leer el menú, hacer un pedido, corregirlo o cancelarlo. Cada método tiene un propósito único y semántico en la ingeniería de integraciones.

Regla de oro

En n8n, el 95% de los nodos de integración usan uno de estos 4 verbos bajo el capó. Si los dominas, puedes integrar cualquier API del planeta, tenga o no nodo nativo en n8n.

2

Los Cuatro Verbos Fundamentales (CRUD)

Estos cuatro métodos corresponden a las operaciones CRUD (Create, Read, Update, Delete) que sostienen toda aplicación moderna.

Verbo Equivalente Acción Técnica Ejemplo Real (Restaurante)
GET READ (Leer) Solicita datos. Nunca modifica nada. "Mesero, tráeme la carta"
POST CREATE (Crear) Envía datos para crear un nuevo recurso. "Mesero, aquí va mi nuevo pedido"
PUT UPDATE (Actualizar) Reemplaza por completo un recurso existente. "Mesero, cambia TODO mi pedido por este otro"
DELETE DELETE (Borrar) Elimina un recurso. "Mesero, cancela el pedido #45"
3

Detalle por Verbo

3.1 — GET: El Lector

El más usado en automatización de lectura. Pide información al servidor y recibe una respuesta (generalmente JSON).

Petición GET a una API de usuarios

// Petición GET a una API de usuarios
GET https://api.miservidor.com/usuarios
// Respuesta del servidor (200 OK):
[
  { "id": 1, "nombre": "Gabriel" },
  { "id": 2, "nombre": "Cliente Potencial" }
]

Cuándo lo usarás en n8n

Para leer contactos de Google Sheets, consultar el estado de un pedido, o buscar si un lead ya existe en tu base de datos antes de procesarlo.

3.2 — POST: El Creador

El verbo de acción más común en ventas. Envías un "cuerpo" (body) con los datos del nuevo recurso que quieres crear.

Petición POST para crear un cliente (Telegram)

// Petición POST para crear un cliente
POST https://api.telegram.org/bot123/sendMessage

// Body (Cuerpo de la petición en JSON):
{
  "chat_id": "987654321",
  "text": "¡Nuevo lead recibido!"
}
// Respuesta (200 OK): Mensaje enviado a Telegram

Crítico

Cuando n8n envía un mensaje a WhatsApp, Telegram o Gmail, está usando POST bajo el capó. Es el verbo de la acción saliente.

3.3 — PUT vs DELETE: El Editor y el Eliminador

Menos frecuentes en automatizaciones simples, pero vitales para flujos robustos de gestión (CRM, inventarios).

EscenarioVerboPor qué
Actualizar estado de un lead a "contactado"PUTModificas un registro existente.
Eliminar un contacto que pidió borrado (RGPD/WhatsApp)DELETERemueves un recurso.
4

Códigos de Estado (Cómo responde el camarero)

Cada vez que haces una petición, el servidor te devuelve un código numérico. Un automatizador profesional debe leerlos; son el pulso de la salud del sistema.

RangoCategoríaSignificado
2xxÉxitoTodo funcionó. 200 OK es el más común.
3xxRedirecciónEl recurso se movió a otra URL.
4xxError del ClienteTÚ hiciste algo mal. 401 (sin auth), 404 (no existe), 429 (demasiadas peticiones).
5xxError del ServidorEL SERVIDOR falló. No es tu culpa. 500 (error interno), 503 (caído).

Diagnóstico del automatizador

Si una automatización en n8n falla y ves un 401 Unauthorized, el problema son las credenciales (tu token/API key). Si ves un 500, el problema es el servidor destino. Un arquitecto nunca confunde al culpable.

5

Checklist del Módulo 02

Desafío conceptual 02

Diagnostica el Flujo

Un cliente te reporta que su automatización de WhatsApp dejó de enviar mensajes. Revisas los logs de n8n y encuentras un error con código HTTP 429 Too Many Requests.

Pregunta: ¿El problema es de credenciales (tu token está mal), de destino (el servidor de WhatsApp está caído), o de volumen (estás enviando mensajes demasiado rápido)? Justifica tu respuesta en una línea.