Las señales cuando algo no salió bien
Cada respuesta de una API trae un código de estado, un número que resume qué pasó. Los 2xx son éxito, los 4xx son problema tuyo (petición mal hecha) y los 5xx son problema del servicio. Leer estos códigos es como leer el tablero del auto: no arreglas el motor con solo mirarlo, pero sabes a dónde mirar. Cuando le pidas algo a una IA para manejar errores, dile explícitamente cómo tratar cada uno.
| Código | Significa | Qué suele hacer tu app |
|---|---|---|
| 200 | Todo bien | Usar la respuesta normalmente |
| 401 | No te reconoció (falta o vence el token) | Volver a autenticar o revisar la llave |
| 404 | No existe ese recurso | Mostrar "no encontrado", no fallar |
| 429 | Lo estás llamando demasiadas veces | Esperar y reintentar más tarde |
| 500 | El servicio se cayó | Reintentar con calma y avisar |
Webhooks: que el servicio te avise a ti
Sin webhooks, tu app tiene que preguntar una y otra vez (sondeo): '¿ya llegó el pago? ¿y ahora? ¿y ahora?'. Un webhook invierte el sentido: le dejas una dirección al servicio y él te avisa cuando algo ocurre. Ejemplo real: un pago que tarda. En vez de preguntar cada cinco segundos, registras un webhook y el servicio te manda una notificación cuando la transferencia se confirma. Ahorras llamadas, dinero y paciencia.
Clasifica cada situación: ¿conviene sondear o usar un webhook?
Sondear (preguntar)
Webhook (que avise)
Tu app de pronto deja de funcionar y la API responde 429. ¿Qué está pasando y qué conviene hacer?
Un plan para una app de IA que llama a una API de pago tiene una decisión peligrosa. Marca la línea.
- Voy a mostrar un mensaje amable cuando la respuesta sea 500.
- Voy a reintentar la llamada infinitamente si recibo 429.
- Voy a registrar cuántas llamadas hago para vigilar el costo.
Identifica la linea con error.
Las APIs con IA suelen ser gratuitas e ilimitadas, así que no hace falta medir el uso.
Para tu producto, anota: una llamada que debe ser webhook y no sondeo, dos códigos de error que manejarás y una forma de vigilar el costo mensual.
Pista
Un buen detalle es un tope de gasto por día que apague la función si se rebasa.Cerraste el curso de APIs
Se requiere 60% de aciertos para avanzar.
Fin del Curso 11. Sigues en el Nivel 1 de la ruta: ahora a Bases de datos para Vibe Coders, donde tus datos dejan de vivir en un Excel y empiezan a escalar.