Errores, límites de tasa y reintentos

Conoce los códigos de error de la API de Claude, distingue un límite de tasa de un límite de gasto y de una sobrecarga, configura los reintentos y timeouts del SDK y escribe tu propio backoff cuando lo necesites.

Es sábado de temporada alta. Viajes Kukulcán lanzó una promoción de Chichén Itzá y el asistente recibe el triple de mensajes de lo normal. De pronto algunas respuestas fallan con un 429, otras con un 529 y un par con un error de conexión. Si tu código trata todos los errores igual, o no trata ninguno, los clientes ven pantallas en blanco justo el día que más importa. En esta lección clasificamos los errores y decidimos qué hacer con cada uno.

Qué verás en esta lección

1. Los códigos de error
2. Tres cosas que parecen iguales y no lo son
3. Límite de tasa (429 con retry-after)
4. Tope de gasto (429 sin retry-after)
5. Sobrecarga (529)
6. Leer los encabezados de límites
7. Lo que el SDK ya hace por ti
8. Un manejo de errores completo
9. Tu propio backoff, cuando lo necesitas
10. Prevenir es mejor que reintentar
11. Práctica
12. Resumen
13. Quiz