APIs y Webhooks en N8N (Teoría)

En esta lección vamos a meternos de lleno con las APIs y los Webhooks en N8n. No te preocupes si suena complicado, lo haremos muy fácil de entender.

Primero, vamos a ver un poquito de teoría para entender qué son las APIs, y luego pasaremos a la práctica con N8n y tres ejemplos súper útiles. ¡Tenme un poco de paciencia con la teoría, que la he preparado para que sea como una chuleta rápida y fácil de digerir!

¿Qué es una API?

Una API significa «Application Programming Interface» (Interfaz de Programación de Aplicaciones). Imagina que quieres que dos aplicaciones diferentes se comuniquen entre sí, como si quisieran hablar el mismo idioma. La API es ese «traductor» o «camarero» que les permite entenderse.

Las aplicaciones crean APIs para que otras aplicaciones (o tú, con N8n) puedan «hablar» con ellas y usar sus funciones. Piensa en esto:

• Documentación: Cada API viene con un manual de instrucciones (la «documentación») que te explica cómo usarla. ¡Es como el menú de un restaurante!
• EnPoint (Punto Final): Cada función específica de una API tiene una dirección única, como una URL, a la que llamamos «EnPoint». Los desarrolladores y herramientas como N8n usan estos EnPoints para pedir servicios a la API.

¿Por qué son tan útiles las APIs?

Las APIs son geniales porque permiten que diferentes aplicaciones trabajen juntas sin problemas. Esto significa que pueden compartir información y funcionalidades. ¡Es como poder usar los superpoderes de una aplicación en otra!

Imagina que necesitas una función que ya existe en otra aplicación. Si esa aplicación tiene una API, ¡no necesitas construirla desde cero! Simplemente llamas a su API y usas esa función. ¡Así de sencillo!

Ejemplos reales de APIs

Para que te hagas una idea, las APIs están por todas partes:

• El tiempo en tu web: Muchas páginas web muestran el pronóstico del tiempo. No es que tengan meteorólogos contratados, ¡se conectan a través de una API a un servicio que ya ofrece esos datos!
• Compartir en redes sociales: Cuando ves un botón para compartir una noticia en Facebook o Twitter, ¡estás usando las APIs de esas redes sociales! Al hacer clic, le dices a la API que comparta esa información.
• Pasarelas de pago: Si tienes una tienda online y tus clientes pagan con PayPal o Stripe, tu tienda está usando las APIs de esas plataformas para procesar los pagos. Tú solo les envías la información y ellas se encargan del resto.
• Iniciar sesión con Google: ¿Alguna vez has iniciado sesión en una app usando tu cuenta de Google? ¡Estás usando la API de Google! Le das permiso a la aplicación para que, a través de la API, verifique tu identidad.

¿Cómo funciona una API?

Vamos a usar una analogía con un restaurante para que lo visualices mejor:

1. El Menú (Documentación): Entras al restaurante, te sientas y miras el menú. Este menú te muestra todo lo que puedes pedir, ¡como la documentación de una API!
2. El Camarero (La Interfaz/API): Decides qué quieres (una hamburguesa y una Coca-Cola) y llamas al camarero. El camarero es como la API, el encargado de tomar tu pedido.
3. La Cocina (La Aplicación): El camarero lleva tu pedido a la cocina (la aplicación). La cocina prepara tu comida basándose en lo que pediste.
4. Tu Comida (La Respuesta): La cocina le entrega la comida al camarero, y él te la trae a tu mesa. ¡Ya puedes disfrutar de tu comida!

En resumen, con una API, tú haces una solicitud (tu pedido) y la API te da una respuesta (tu comida).

Componentes de una solicitud API

Cuando haces una solicitud a una API, generalmente tiene estos cuatro componentes:

1. URL (EnPoint): Es la dirección única de la función que quieres usar. Piensa en ella como la dirección de un lugar específico en una ciudad.
   • Tiene partes como el «schema» (http o https), el «host» (el nombre del sitio web), el «path» (la ruta específica) y, a veces, un «puerto» y «parámetros de consulta».
   • Los parámetros de consulta son datos extra que le pasas a la API para darle más contexto a tu solicitud. Empiezan con un signo de interrogación ? y se separan con un & si hay varios.
2. Método: Describe qué acción quieres realizar en esa URL. Los más comunes son:
   • GET: Para recibir datos. Es como «dame la información meteorológica actual». ¡Piensa en leer un libro!
   • POST: Para enviar datos nuevos. Es como «registra esta información de producto». ¡Piensa en enviar una carta!
   • PUT: Para actualizar datos existentes por completo. Como reemplazar una página entera de un libro.
   • PATCH: Para actualizar solo una parte de los datos. Como corregir solo una palabra en una página.
   • DELETE: Para eliminar datos. Como borrar una página del libro.
3. Header (Encabezado): Aquí se envía información adicional sobre tu solicitud, como el idioma que prefieres, el tipo de dispositivo que estás usando, etc. Le da más «contexto» a la API. Por ejemplo, Accept: application/json le dice a la API que esperas la respuesta en formato JSON.
4. Body (Cuerpo): Esto es opcional y solo se usa principalmente con el método POST (cuando envías información). Contiene los datos reales que quieres enviar a la aplicación. Por ejemplo, en un formulario, el «body» contendría tu nombre, apellido y correo electrónico.

¡No olvides las credenciales!

Las credenciales son súper importantes. Imagina que cualquiera pudiera acceder a tu correo electrónico o a tu Google Drive a través de una API. ¡Sería un caos! Por eso, la mayoría de las APIs te piden una autentificación. Esto es como mostrar tu carné de identidad para que la API sepa que eres tú y que tienes permiso.

Las formas más comunes de autentificarse son:

• En la URL, como un parámetro: ?apiKey=TU_CLAVE_AQUI
• En el «Header», usando Authorization: Bearer TU_CLAVE_AQUI

Esto lo veremos con más detalle cuando estemos en N8n.

Componentes de una respuesta API

Una vez que has hecho tu solicitud, la API te envía una respuesta. Esta respuesta suele tener:

1. Código de Estado: Es un número de 3 dígitos que te dice si tu solicitud fue exitosa o si hubo algún problema.
   • 200 OK: ¡Todo perfecto! La solicitud fue exitosa.
   • 401 Unauthorized: Problema con tu autentificación. Revisa tus credenciales.
   • 404 Not Found: El recurso que buscabas no existe en esa URL. Revisa la dirección.
   • 500 Internal Server Error: Error en el servidor de la aplicación. Inténtalo más tarde.
2. Header (Encabezado): Al igual que en la solicitud, aquí se envía información extra sobre la respuesta, como el tamaño del contenido o el tipo de formato de los datos.
3. Body (Cuerpo): ¡Estos son los datos reales que te devuelve la API! Pueden venir en diferentes formatos, como HTML (si es una página web), JSON (un formato muy común para datos), o incluso archivos binarios.

Webhooks (La API Inversa)

Imagina que has pedido un paquete de Amazon y estás en casa esperándolo. Tienes dos maneras de saber si ha llegado:

1. Preguntar constantemente: Ir a la puerta cada dos minutos, abrir y ver si ya está el repartidor. Esto sería como hacer solicitudes GET constantemente a una API, preguntando si hay novedades. ¡Un poco cansado!
2. Esperar que suene el timbre: ¡Mucho más cómodo! Simplemente esperas a que el repartidor toque el timbre.

Un Webhook es como ese timbre. En lugar de que tú tengas que estar preguntando a la aplicación si algo ha pasado, la aplicación te avisa (te «toca el timbre») cuando sucede algo importante.

• Los Webhooks esperan a que algo suceda. Por eso son ideales para usar como «triggers» (desencadenadores) en N8n.
• Para configurar un Webhook, necesitas una URL. Cuando el evento que esperas sucede en la aplicación, esta envía información a esa URL, y N8n (o tu sistema) se entera al instante.

¡Ahora a la práctica en N8n!

Ya tenemos la teoría, ¡es hora de poner las manos en la masa! En N8n, vamos a ver ejemplos con:

• OpenWeather: Para obtener la previsión del tiempo.
• JSONPlaceholder: Un servicio para probar APIs fácilmente.
• Tably: ¡Este es genial! Permite a tus automatizaciones buscar información en Internet en tiempo real, algo que ChatGPT o la mayoría de los modelos de IA no hacen por sí solos.

¡Prepárate, que en el siguiente segmento nos metemos de lleno en N8n!