📡
DataForge Lead API
broad-bonus-2baf · Multi-tenant · Rate Limiting · Telegram Notifications
Rate LimitingDedup SHA-256Telegram
Multi-tenantD1 + KV
Estado
⚠️ Bindings Faltantes
Worker CF
broad-bonus-2baf
Bindings D1+KV
✅ Desplegados
D1 Schema
clients + events ✅
Agentes
Daniel · CF · Marketing
✅ D1 binding (DB) y KV binding (DF_KV) ya desplegados el 2026-03-10. Solo falta el secret ADMIN_TOKEN y el route/dominio.
⚠️ Pendiente: Agregar secret ADMIN_TOKEN en CF Dashboard → broad-bonus-2baf → Settings → Environment Variables.
📋 Descripción del Proyecto
DataForge Lead API es una API SaaS de captura de leads multi-tenant construida sobre Cloudflare Workers. Permite a agencias y empresas recibir leads desde formularios web y notificarlos instantáneamente por Telegram, con deduplicación automática, rate limiting por cliente y planes de monetización escalables.
STARTER
$0
1.000 eventos/mes
1 canal Telegram
API key incluida
PRO
$29/mes
50.000 eventos/mes
5 canales Telegram
Analytics básico
BUSINESS
$79/mes
Ilimitado
Multi-canal Telegram
Priority support
⚙️ Cómo Funciona
🌐
Form/Webhook
Cliente envía lead via POST /api/ingest
→
🔑
API Key Auth
Bearer token valida al cliente en D1
→
🛡️
Rate Limit + Dedup
60 req/min · dedup 10min por SHA-256
→
💾
D1 Storage
Evento guardado en tabla events
→
📲
Telegram
Notificación instantánea al canal configurado
🔌 Endpoints API
POST/api/ingestCapturar lead · Auth: Bearer {api_key}
GET/api/events?limit=50Listar eventos del cliente
POST/admin/create-clientCrear cliente · Header: X-Admin-Token
POST/admin/set-telegramConfigurar bot Telegram por cliente
GET/healthHealth check
✨ Funcionalidades
- ✅ Autenticación por API key por cliente (multi-tenant)
- ✅ Rate limiting: 60 req/min por cliente con ventana KV
- ✅ Deduplicación automática: fingerprint SHA-256 del payload (10 min TTL)
- ✅ Notificación Telegram por cliente (bot_token + chat_id en KV)
- ✅ Planes de servicio: starter / pro / business
- ✅ D1 binding (DB) y KV binding (DF_KV) configurados ✅
- ✅ Schema D1 migrado: clients + events
- ⏳ Secret ADMIN_TOKEN (agregar en CF Dashboard)
- ⏳ Route / dominio asignado
- ⏳ Dashboard web para clientes (ver stats de leads)
- ⏳ Stripe para cobro de suscripciones
📈 Progreso por Fase
D1 + KV Bindings desplegados100%
📌 Acciones Pendientes
CF Dashboard → broad-bonus-2baf → Settings → Agregar secret: ADMIN_TOKEN = tu_valor_secreto
→ Tú / CF Dashboard
Agregar route/dominio al Worker (ej: leads.vulnerafix.com o dataforge.io)
→ Cloudflare
Crear primer cliente: POST /admin/create-client con X-Admin-Token header
→ Cloudflare / Daniel
Configurar Telegram: POST /admin/set-telegram con bot_token y chat_id del cliente
→ Daniel
Landing page marketing con pricing Starter/Pro/Business y formulario demo
→ Marketing + Daniel
DataForge está a 1 secret de funcionar
D1 + KV bindings ya configurados · Solo falta ADMIN_TOKEN + route
⚡ Ir al CF Dashboard