Dependes de algo que no controlas
Cuando consumes una API de terceros, tu app funciona bien… hasta que el servicio se cae, cambia o te avisa que ya usaste tus 1.000 llamadas del día. Un builder profesional no se sorprende: lee el código de estado, respeta la cuota y conoce la tarifa. Y siempre define qué hace su app cuando el servicio falla.
Los códigos que debes saber leer
| Código | Familia | Qué significa para ti |
|---|---|---|
| 2xx | Éxito | la llamada funcionó; usa los datos |
| 400 | Error del cliente | enviaste algo mal (falta un campo, formato inválido) |
| 401 / 403 | Autenticación / permiso | clave ausente o sin autorización: no es un bug, es acceso |
| 404 | No encontrado | el recurso o la ruta no existe |
| 429 | Demasiadas peticiones | te pasaste de cuota: espera y reintenta más lento |
| 5xx | Error del servidor | el problema es del servicio; reintenta más tarde |
Cuotas y tarifas: la letra pequeña
Cada servicio impone límites (cuántas llamadas por minuto/día) y precios (a veces por llamada). Sin plan, una app popular agota la cuota y se queda ciega, o te sorprende con una factura. Tu trabajo de director es fijar la estrategia antes de construir.
Al integrar la API externa, implementa manejo de fallos:\n- guarda la clave en variable de entorno, nunca en el frontend\n- si recibes 429, no satures: reintenta con espera creciente (backoff)\n- si 5xx, muestra el ultimo dato valido en cache y avisa "temporalmente no disponible"\n- si 400/404, muestra el error al usuario sin reintentar (es mi culpa, no del servicio)\n- registra cada llamada para no pasarme de la cuota diaria de 1000\n\nExplica cada estrategia en una frase.Para reforzar
Webhooks, errores HTTP y costos de uso
OA publicado sobre errores HTTP y costos. Aquí convertimos ese conocimiento en una política de reintento y cache que le exiges a la IA.
Prueba
La API te devuelve 429 de forma repetida. ¿Qué está pasando y qué conviene hacer?
Ante un error 5xx del servicio, la mejor estrategia es reintentar en bucle cerrado hasta que funcione.
Detecta el manejo de errores ingenuo
Revisas cómo una IA maneja los fallos de la API externa. Señala la decisión que empeorará la situación:
- Guarda el último dato válido en caché para mostrarlo si el servicio falla.
- Ante un 429, reintenta inmediatamente en bucle hasta que deje de fallar.
- Registra cuántas llamadas hace para no exceder la cuota diaria.
- Distingue errores 4xx (míos) de 5xx (del servicio).
Identifica la linea con error.
Para la API de tu proyecto, escribe qué hará tu app ante cada uno: 400, 401, 404, 429, 500. Un botón de «no disponible con datos antiguos» vale más que una pantalla rota.