El reto: que dos sistemas se hablen sin que nadie capture datos a mano

Mapa conceptual

# Reto: conecta dos APIs
## El reto: que dos sistemas se hablen sin que
## Contexto · Wikipedia
## Anatomía de un puente

Contexto · Wikipedia

Reto: Reto puede referirse a: Amikeca Reto, "Red de la amistad" en esperanto. Competición, desafío. Los habitantes de Retia.

Wikipedia: Reto
Texto consultado y adaptado de Wikipedia (licencia CC BY-SA 4.0).

Lago que conecta a las dos partes de la Isla de la Llorona.JPG — Imagen libre de Wikimedia Commons (CC BY-SA 4.0, autor: EmyPheebs)

Especificación mínima (elige UN puente): (a) formulario web → nueva fila en hoja de cálculo de Google; (b) mensaje de texto/WhatsApp simulado → ticket creado en tu sistema del reto 2; (c) alta en tu CRM → contacto creado en otra herramienta. El puente debe: autenticarse, mapear campos (el mundo real nunca se llaman igual) y no perder datos cuando algo falle. Fuera del alcance: interfaces bonitas, múltiples destinos, colas y reintentos sofisticados, dashboard de monitoreo. Este reto introduce algo que los tres anteriores no tenían: un socio que se cae, te cambia el formato y te dice que no. Ahí aprendes que una integración no es el camino feliz, es el manejo del camino triste.

La llave API no se comparte, no se sube y no se imprime Regla de higiene que no es opcional: las credenciales van en variables de entorno, nunca en el código que pegas al foro ni que subes a un repositorio. Si una llave se expuso, se revoca y se regenera: en el laboratorio y en la vida.

Anatomía de un puente

Cómo atacarlo

Tu lado es un formulario; el lado que manda el formato es la API externa. Pide a la IA que te resuma el endpoint, la autenticación y un ejemplo de respuesta.
Antes de construir nada, haz UNA llamada manual (curl o herramienta web) que regrese 200. Sin ese verde, todo lo demás es culpar al viento.
nombre_del_formulario → nombre_en_la_API, con tipo y obligatorio/opcional. El mapeo es el 80% de los bugs de integración.
Envío → llamada → confirmación visible. Un solo caso, probado tres veces.
Sin internet, credencial caducada, respuesta rara. El dato NO se pierde: se guarda pendiente con aviso claro. Demo: un envío feliz y uno recuperado.

La diferencia entre demo e integración no se ve el día que funciona: se ve el día que algo falla.
Falla inyectada	Lo que hace una demo	Lo que hace una integración
Sin conexión	Pantalla en blanco o error feo	Guarda el intento, avisa "pendiente, reintentará"
Token expirado	Cree que "no hay datos"	Distingue 401 de 200-vacío y pide re-autenticación
Campo faltante	Envía y reza	Valida antes de enviar y dice CUÁL falta
Formato cambiado	Rompe en silencio	Registra la respuesta cruda para diagnosticar

Tu puente formulario → hoja funciona en tu laptop, pero al enviar desde el celular del compañero no pasa nada y la hoja no muestra error. Según el método del reto, ¿cuál es la primera acción?

Para este reto, validar los campos del formulario ANTES de llamar a la API externa es parte de la integración, no un adorno opcional.

Escribe tu tabla de mapeo (campo de tu origen → campo del destino, tipo, obligatorio) ANTES de promptear el puente, y anota las 3 fallas que vas a inyectar en la prueba. Compártela: el mapeo es el entregable intelectual de este reto.

Pista

Si tu tabla tiene 4 filas y el formulario tiene 9 campos, hay 5 campos viajando a la intemperie.

Siguiente reto: Crea un micro-SaaS — el jefe final del laboratorio: todo junto (app, datos, IA, un cobro) alrededor de un dolor que ya sabes costear.

Sigue: Cómo usar el laboratorio
Objeto de la misma ruta para continuar aprendiendo.