VulneraFix API — PROJ-003

🔌

VulneraFix
API

API pública de ciberseguridad · api.vulnerafix.com · SaaS B2B

⚡ Ver API Health ← Dashboard

Progreso general35%

Endpoint base

api.vulnerafix.com

Worker CF

vrm-backend (PROJ-W04)

Base de datos

D1 · vulnerafix_db

Auth

Bearer Token · PBKDF2

📋 Descripción del Proyecto

VulneraFix API es la capa de integración B2B que expone los servicios de gestión de vulnerabilidades (VRM) a sistemas externos. Permite a empresas integrar capacidades de escaneo, evaluación de riesgos y remediación directamente en sus flujos de trabajo via REST API. Construida sobre Cloudflare Workers + D1, ofrece baja latencia global, alta disponibilidad y autenticación segura con tokens Bearer.

🔌 Endpoints Disponibles

GET /health Estado del servicio y versión

POST /register Registro de nuevo cliente API

POST /login Autenticación y obtención de token JWT

GET /me Datos del cliente autenticado

POST /scan [PENDIENTE] Iniciar escaneo de vulnerabilidades

GET /reports/:id [PENDIENTE] Obtener reporte de vulnerabilidades

GET /risks [PENDIENTE] Listado de riesgos identificados

📄 Ejemplo de Uso

# Health check
GET https://vrm-backend.workers.dev/health

# Registro
POST /register
{"email":"cliente@empresa.com","password":"SecurePass123","company":"Acme Corp"}

# Login
POST /login
{"email":"cliente@empresa.com","password":"SecurePass123"}
→ {"token":"eyJ...","expires_in":86400}

# Consulta autenticada
GET /me
Authorization: Bearer eyJ...
    

⚡ Capacidades del Sistema

Worker CF desplegado y activo (vrm-backend)
Base de datos D1 con esquema migrado (vulnerafix_db)
Registro de usuarios con PBKDF2 (180K iterations)
Autenticación con token Bearer (24h TTL)
Endpoint /health operativo
Mapeo de subdominio api.vulnerafix.com al Worker
Endpoints de escaneo y reportes
Rate limiting y cuotas por plan
Documentación API pública (Swagger/OpenAPI)
Dashboard de uso para clientes API
Webhooks de notificación

📅 Fases de Desarrollo

Fase 1 — Infraestructura base y auth90%

Fase 2 — Endpoints de negocio15%

Fase 3 — Documentación y portal developer5%

Fase 4 — Monetización por uso (API keys)0%

⏳ Pendientes Críticos

Configurar DNS: api.vulnerafix.com → vrm-backend.workers.dev

→ Daniel (Cloudflare DNS)

Implementar endpoints /scan, /reports y /risks con lógica de negocio

→ Daniel (CF Workers dev)

Publicar documentación OpenAPI en developer.vulnerafix.com

→ Daniel + Marketing

Definir modelo de pricing por llamadas API (freemium/pro)

→ Marketing

🏷️ Stack Tecnológico

Cloudflare Workers D1 SQLite PBKDF2 Auth Bearer Token REST API JSON OpenAPI 3.0

⚡ Entrar al Proyecto — API Health Check