Sistemas distribuidos · Entrega de webhooks

Relay

2026 / v1.0

Una plataforma de entrega de webhooks que convierte reintentos, fallos del receptor, firmas y recuperación en un ciclo durable que los operadores pueden inspeccionar.

Rol
Diseño de sistemas + ingeniería full-stack
Plataforma
Cloudflare Workers
Topología
Workers · D1 · Queues · Cron
Repositorio
Público
Página de Relay que presenta infraestructura de webhooks inspeccionable
Relay v1.0 · Infraestructura de entrega en producción

01

El problema de confiabilidad

Enviar una solicitud HTTP es sencillo. Preservar la intención de entrega entre timeouts, límites, interrupciones, rotación de secretos e incidentes es un problema de sistemas distribuidos.

Relay garantiza que cada evento aceptado tenga trabajo durable, que los reintentos sean limitados y explicables, que el receptor pueda deduplicar y que exista evidencia suficiente para entender cada resultado.

02

Arquitectura durable

D1 es la fuente de verdad. Queue transporta identificadores listos, mientras un Worker programado republica trabajo pendiente, recupera leases vencidos y aplica retención limitada.

01

Al menos una vez, sin prometer exactamente una vez

Un identificador estable permite deduplicación mientras la recuperación acepta que una entrega de red puede repetirse.

02

Outbox transaccional

El evento, el fanout y la intención de publicación se confirman juntos para que el trabajo aceptado no desaparezca.

03

D1 programa; Queue transporta

D1 conserva fechas, política de reintento y recuperación. Queue despierta únicamente el trabajo listo.

04

La evidencia es parte del producto

Cada intento guarda evidencia limitada y redactada para explicar reintentos, replay y resultados terminales.

05

Fallos públicos controlados

Failure Lab ofrece siete comportamientos fijos con Turnstile y cuotas, sin aceptar URLs o payloads arbitrarios.

03 / Evidencia operativa

La historia exacta de cada reintento.

Inspector de Relay con dos intentos HTTP 503 seguidos por un HTTP 200
Una entrega, tres intentos persistidos y el motivo de cada reintento

04 / Demostración pública

Rompe el receptor. Observa cómo Relay se recupera.

Siete escenarios controlados hacen visibles el éxito, los reintentos, rate limiting, timeout, fallos permanentes y agotamiento directamente en producción.

Failure Lab de Relay con siete escenarios deterministas
Failure Lab · Fallos seguros, deterministas e inspeccionables

05

Calidad y prueba de producción

La entrega combina pruebas de aplicación y Worker con D1, recorridos de navegador, accesibilidad, seguridad de publicación, límites de costo y un reintento controlado en producción.

En producción, el receptor inestable respondió 500 dos veces y 200 en el tercer intento. Relay mantuvo una identidad estable, generó firmas nuevas y registró cada recibo.

283
pruebas de aplicación y contratos compartidos
12
recorridos de navegador, accesibilidad y responsive
9
verificaciones de publicación y configuración

06

Resultado

Relay demuestra razonamiento de producción más allá de CRUD: límites transaccionales, concurrencia, criptografía, clasificación de fallos, operación consciente de costos y entrega respaldada por evidencia.