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?
Arrastra cada ficha a su categoría (o tócala y luego toca la categoría). También puedes usar el teclado.
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.
Marca la línea o las líneas con error y pulsa Comprobar.
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.
Un buen detalle es un tope de gasto por día que apague la función si se rebasa.
Tu texto se guarda sólo en este dispositivo.
Cerraste el curso de APIs
Aquí se mira lo que ya fuiste acertando. Pulsa «Comprobar» para saber si puedes seguir.
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.
Comentarios
Inicia sesión para comentar.
Todavía no hay comentarios. Sé la primera persona en opinar.