NOTAS SOBRE ALERTAS DE CAÍDA
Recuperar las caídas que te perdiste estando offline
El stream no reemite lo que disparó durante un apagón. El endpoint REST de caídas guarda el registro; así se mezcla sin duplicar.
El lector estuvo fuera una hora: un despliegue, un proceso caído, un portátil que se durmió. El stream reconecta limpio, pero la reconexión solo cubre lo que pasa de aquí en adelante. Las caídas que dispararon mientras estabas fuera no se reemiten. Recuperarlas es un paso deliberado, y el endpoint REST de caídas es la herramienta para ello.
Acepta que el hueco es real
El stream empuja alertas conforme se detectan las caídas y no guarda backlog para ti. Cuando tu lector reconecta, empieza desde ahora. Cualquier cosa que se movió durante el apagón existe solo en el registro que la API mantiene, que es exactamente lo que el endpoint sirve: las mismas caídas, consultables bajo demanda, como presenta la comparación entre stream y endpoint, verificado el 2026-10-28.
Así que la recuperación tiene dos mitades: pon el stream en marcha de nuevo, luego pregunta al endpoint qué te perdiste. Saltarse la segunda mitad deja un hueco que luego se lee como mercado tranquilo.
Pide la ventana al endpoint
Consulta el endpoint de caídas para la ventana del apagón, filtrado por tus deportes. La página de comparación documenta la diferencia de forma que importa aquí: el endpoint devuelve objetos con from, to, market, side y sport_name, y añade tres campos que el stream no lleva: drop_pct, age_s e is_live. El porcentaje y la edad vienen calculados, lo cual es cómodo, y los nombres de campo son distintos, lo cual es la trampa.
Escribe el mapeo una vez y guárdalo junto al relé: from_price lee from, to_price lee to, sect lee market, outcome lee side. Código que aplica los nombres de campo del stream a los objetos del endpoint pierde los números en silencio, el tipo de bug que parece un resultado vacío.
Mezcla sin duplicar
Tu almacén de deduplicación decide cuánto costó el apagón. Casa cada fila del endpoint con las alertas que registraste antes del hueco, por evento y selección, como las clavea la guía de deduplicación, verificado el 2026-10-28. Lo que ya está en el almacén es duplicado; lo nuevo pertenece al registro con una marca que dice que llegó tarde.
Esa marca importa más de lo que parece. Una alerta recuperada es evidencia sobre el mercado en el momento de la alerta, no una señal para actuar ahora. Dirige las alertas recuperadas al registro y al resumen de la mañana, no al canal que despierta gente, salvo que tu revisión de cada una diga lo contrario.
Mide el apagón, no solo el hueco
Cierra el ciclo con dos números: cuánto duró el hueco, y cuántas caídas mostró el endpoint para él. El primero dice si tu política de reinicio hace su trabajo. El segundo dice cuánto cuesta el tiempo caído en tus deportes, que es el número que defiende un lector de reserva más adelante.
Un apagón tratado así no deja nada atrás: el stream está en vivo, el registro está completo, y el log dice claramente qué entradas fueron recuperadas. El mercado siguió moviéndose mientras estabas fuera. Ahora tus registros están de acuerdo.