Qué es una API explicado para quien no programa, con un caso real

Una API es la puerta por la que un programa le pide cosas a otro programa. Tú mandas una petición diciendo qué quieres, el otro te devuelve los datos, y ya está.

Esa es la definición entera. No hace falta la metáfora del camarero que te toma nota, que además nunca la he entendido del todo y creo que confunde más que aclara.

Lo que sí voy a hacer es enseñarte una API funcionando en mi propia web, porque el concepto se entiende en treinta segundos cuando lo ves con datos que reconoces.

¿Qué es una API y para qué sirve?

Las siglas significan interfaz de programación de aplicaciones, lo cual no ayuda absolutamente nada. Quédate con esto: es un menú de cosas que un programa te deja pedirle desde fuera.

Cada cosa del menú tiene una dirección. Tú llamas a esa dirección, normalmente con una clave para identificarte, y recibes una respuesta en texto ordenado.

Sirve para que dos programas que no se conocen de nada puedan trabajar juntos sin que nadie copie y pegue datos a mano. Eso es todo. Pero es que "copiar y pegar datos a mano" es literalmente en lo que se le va el día a media humanidad.

El caso real: la bandeja de ideas de mi web

Tengo en rubenloan.com un panel donde se acumulan ideas de contenido. Ahí van cayendo cosas que surgen mientras trabajo: un ángulo que me sale hablando de un tema, una frase que suena a título, algo que aprendo montando cualquier cosa.

El problema era el de siempre. Las ideas surgen mientras estoy haciendo otra cosa, y si tengo que parar, abrir el navegador, entrar al panel y escribirla, no la apunto. Nunca. Se pierde.

La solución fue una API. La web tiene una dirección interna donde se pueden crear ideas. Cualquier herramienta mía puede llamar a esa dirección con la idea dentro y queda guardada, sin que yo abra nada.

En la práctica funciona así: estoy trabajando en cualquier cosa, aparece algo que vale la pena, y se guarda al vuelo. Yo sigo con lo mío. Cuando me siento a planificar contenido, las ideas están todas ahí, con la nota de en qué contexto salieron.

La API no es lista. Es una puerta. Lo que la hace útil es que está abierta cuando hace falta.

Las cuatro piezas de cualquier API

Cuando abras la documentación de una herramienta y te den ganas de cerrar la pestaña, busca estas cuatro cosas. Están siempre y son lo único que importa al principio:

La dirección. Un enlace, largo y feo, que apunta a lo que quieres. Algo tipo la dirección de la herramienta seguida de la palabra que describe el recurso.

El método. Una palabra que dice qué quieres hacer. Pedir datos, crear algo nuevo, cambiar algo que ya existe, borrar. Cuatro verbos, y en la documentación vienen marcados con colores para que no te pierdas.

La autenticación. Una clave secreta que dice quién eres. Se genera en los ajustes de la herramienta. Trátala como una contraseña, porque lo es: si alguien la tiene, puede hacer en tu cuenta lo mismo que tú.

Los datos. Lo que mandas o lo que recibes, en un formato ordenado con nombres y valores. Se llama JSON y se lee sorprendentemente bien: nombre de la cosa, dos puntos, valor de la cosa.

Con eso ya puedes usar cualquier API sin tener ni idea de programar, sobre todo si la conectas desde una herramienta de automatización tipo n8n, donde rellenas esos cuatro campos en una pantalla y ya está.

API y webhook no son lo mismo

Esta confusión la tiene todo el mundo, y es la más útil de resolver.

Con una API, tú preguntas. Vas tú, cuando quieres, y pides los datos. La flecha va de ti hacia fuera.

Con un webhook, a ti te avisan. Tú te quedas quieto y el otro sistema te llama cuando pasa algo. La flecha viene de fuera hacia ti.

Se usan juntas constantemente. El webhook te avisa de que ha pasado algo, y tú entonces llamas a una API para conseguir los detalles o para hacer la siguiente acción. Lo tengo explicado en detalle en el post de qué es un webhook.

Truco para no confundirte nunca: si la frase empieza por "yo quiero saber", es una API. Si empieza por "avísame cuando", es un webhook.

Otros tres ejemplos de andar por casa

El botón de "iniciar sesión con Google". Cuando lo pulsas, la web le pregunta a Google por API si eres quien dices ser. La web nunca ve tu contraseña. Solo recibe un "sí, es esta persona".

El mapa incrustado en la página de un restaurante. Esa web no tiene un mapa del mundo guardado. Se lo pide a un servicio de mapas por API cada vez que alguien entra.

Los precios de envío en una tienda. Cuando metes tu código postal y aparece el coste del envío, la tienda acaba de preguntarle a la empresa de transporte cuánto cuesta llevar eso ahí.

En los tres casos, dos programas hablando entre ellos mientras tú te crees que estás usando uno solo. Cuando empiezas a verlo, lo ves en todas partes.

Lo que una API no es

No es una interfaz para humanos. Si abres la dirección de una API en el navegador, te va a salir un churro de texto. No está rota. Es que no está hecha para que la leas tú.

No es gratis siempre. Muchas cobran por número de llamadas. Si montas algo que consulta cada minuto sin necesidad, te puedes llevar una sorpresa a fin de mes. Consulta lo que necesites y guarda el resultado si lo vas a reutilizar.

No es estable para siempre. Las herramientas cambian sus APIs. Un día lo que funcionaba deja de funcionar porque han cambiado un nombre de campo. Por eso conviene que lo que montes te avise cuando falle, en vez de fallar en silencio durante tres semanas.

No te da acceso a todo. Cada API expone lo que su dueño quiere. Hay funciones de la interfaz web que simplemente no están disponibles desde fuera, y no hay vuelta de hoja.

Por dónde empezar si nunca has tocado una

Haz una llamada de mentira a algo público. Hay APIs abiertas de cosas tontas (el tiempo, chistes, datos de países) que no piden clave ni nada.

Coge una herramienta de automatización, mete un bloque de petición, pega la dirección, ejecuta. Ver aparecer los datos en pantalla es el momento en el que la palabra deja de dar respeto.

Después ya puedes ir a lo tuyo: la API de tu herramienta de correo, la de tu tienda, la de tu gestor de tareas. Todas funcionan igual. Cambia la dirección y cambian los nombres de los campos, pero el mecanismo es idéntico.

Y si te preguntas hasta dónde llega esto encadenado con IA, tengo montado un ejemplo largo en el simulador de APIs humanas con Claude, que es la vuelta de tuerca de todo esto. El terreno completo lo tienes en el hub de automatización y agentes con IA.

Si no sabes qué se puede automatizar en lo que tú haces, el test de IA te da una lectura rápida de por dónde empezar sin comerte la documentación de nadie.

Hacer el test de IA