API: conecta otros servicios
Lección 16 de 26 del curso «Vibe coding». Gratis, con animaciones y un test.
API: programas que conversan
Una API (interfaz de programación) es la forma en que un programa le pide algo a otro. Como un mesero: no entras a la cocina, das tu pedido y te traen el plato. Tu servidor envía una petición y el servicio responde con datos. Ejemplo de la lección: un sitio de reservas para tu amigo barbero. Un cliente reserva y el sitio solo envía un correo, cobra un anticipo y responde preguntas.
Qué puedes conectar
Casi todo lo útil ya existe como API. Correo: Resend o Brevo envían «tienes cita el viernes». Pagos: Stripe o un servicio de pagos local de tu país. IA: la API de Anthropic u OpenAI, para que un bot responda a los clientes. Y además clima, mapas, traducción. En el esquema es el bloque de la derecha. Revisa si el servicio y el pago están disponibles en tu país.
El camino de la clave
La conexión casi siempre es igual. 1) Te registras en el servicio. 2) Obtienes una clave de API: una contraseña para programas (lección de claves). 3) La pones en las variables de entorno del servidor, no en el código. 4) El servidor usa la clave para llamar a la API. 5) El frontend solo llama a tu servidor. El navegador no ve la clave: como en el esquema, vive en el servidor.
Webhook: el servicio te llama
Normalmente llamas tú: tu servidor pregunta y el servicio responde. Un webhook es al revés: el servicio toca a la dirección de tu servidor cuando pasa algo. Ejemplo: un cliente paga el corte, el servicio de pagos envía el webhook «pago exitoso» y tu servidor marca la cita como pagada. Es la flecha punteada del esquema. Verifica la firma del webhook: así el servidor sabe que de verdad es el servicio y no un bromista.
Documentación y modo de prueba
La documentación es el manual del servicio para usar su API. Dale al agente el enlace y pídele que la siga: así inventa menos. Empieza en modo de prueba: los servicios de pago tienen un sandbox donde los pagos son falsos y no se mueve dinero. Recorre todo el camino: reserva, correo, pago, webhook. ¿Funciona? Solo entonces cambia a las claves de producción, o sea, las reales.
Ponte a prueba
- ¿Dónde debe estar la clave de API del servicio de pagos?
Respuesta correcta: En las variables de entorno del servidor. La clave en el servidor no la ve el navegador. El frontend le pide a tu servidor, y el servidor llama a la API con la clave. - ¿Qué es un webhook?
Respuesta correcta: El servicio llama a tu servidor cuando pasa algo. Normalmente pregunta tu servidor. El webhook es al revés: el servicio te avisa, por ejemplo «pago exitoso». - ¿Cómo empezar a conectar los pagos?
Respuesta correcta: Con el modo de prueba, sin mover dinero. En el sandbox puedes probar todo el camino sin riesgo. Las claves reales van cuando todo funciona.
← Base de datos e inicio de sesión Tareas en segundo plano y horarios →