boltBitnodo Analytics API

Quickstart para integrador

1. Desarrolladores crea una superclave temporal para el cliente.
2. Registrar cuenta y usuario con POST /auth/register + super_key.
3. Guardar access_token, user.id, account.id y api_key.
4. Crear portal con POST /portals usando Bearer token.
5. Incrustar el widget JS con data-key y data-tenant (modo recomendado) o usar modo manual con companyId/portalId.
6. Consumir alertas y eventos con X-API-Key.

curl -X POST "https://analytics.bitnodo.net/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "owner@empresa.com",
    "password": "SuperPassword123!",
    "full_name": "Owner Demo",
    "account_name": "Empresa Demo",
    "super_key": "ABCD2345EFGH6789IJKL2345MNOP6789"
  }'

Aprobacion por superadmin

El alta de integradores no es libre. Cada registro requiere una super_key temporal emitida por Bitnodo. Esta clave es alfanumerica segura, de un solo uso y se marca como consumida inmediatamente cuando la cuenta se crea.

La super_key aplica solo al alta inicial de la cuenta/empresa. La creacion, edicion y eliminacion de portales se realiza con Bearer token y no requiere superclave.

Autenticacion

curl "https://analytics.bitnodo.net/api/v1/auth/me" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN"

Ejemplo JavaScript — login y autenticacion

// 1. Login y obtener access_token
const loginRes = await fetch('https://analytics.bitnodo.net/api/v1/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: 'owner@empresa.com', password: 'SuperPassword123!' })
});
const { access_token, user, account } = await loginRes.json();
// Guardar para uso posterior:
// access_token → Bearer token para portales / configuracion
// account.api_key → X-API-Key para lectura de alertas / visitas

// 2. Verificar sesion activa
const meRes = await fetch('https://analytics.bitnodo.net/api/v1/auth/me', {
  headers: { 'Authorization': `Bearer ${access_token}` }
});
const profile = await meRes.json();
console.log(profile.user.id, profile.account.id, profile.tenant.id);

Gestion de portales (CRUD)

Un usuario autenticado puede crear multiples portales/paginas para monitoreo usando su Bearer token. Este flujo no utiliza super_key.

Limites por plan: free permite 1 portal; pro permite hasta 50 portales.

curl -X POST "https://analytics.bitnodo.net/api/v1/portals" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sitio principal","domain":"www.empresa.com"}'

Ejemplo JavaScript — crear y listar portales

const headers = {
  'Authorization': 'Bearer TU_ACCESS_TOKEN',
  'Content-Type':  'application/json'
};

// Crear portal
const createRes = await fetch('https://analytics.bitnodo.net/api/v1/portals', {
  method: 'POST',
  headers,
  body: JSON.stringify({ name: 'Sitio principal', domain: 'www.empresa.com' })
});
const { portal } = await createRes.json();
console.log('Portal ID:', portal.id); // Guardar para widget y tracking

// Listar portales
const listRes = await fetch('https://analytics.bitnodo.net/api/v1/portals', { headers });
const { portals } = await listRes.json();

Reglas de intencion por portal

Cada portal puede configurar su propio scoring de intencion mediante intent_rules. Si un portal no define reglas personalizadas, el sistema usa reglas por defecto globales.

{
  "rules_json": {
    "pageview": 1,
    "scroll_depth": {"50": 1, "75": 2, "100": 3},
    "link_click": 2,
    "video_play": 2,
    "file_download": 4,
    "form_submit": 10,
    "commercial_url_bonus": 5
  },
  "threshold_interested": 6,
  "threshold_high": 11,
  "threshold_very_high": 21
}

Widget unico de rastreo

Desde esta iteracion, el panel de Bitnodo puede generar automaticamente el snippet de instalacion consultando una configuracion publica por tenant.

Flujo de instalacion: panel -> API -> JSON de configuracion -> snippet -> cliente copia y pega.

<script
  src="https://analytics.bitnodo.net/widget/tracker.js"
  data-key="pk_live_xxxxxxxxx"
  data-tenant="23"
></script>

Configuracion JSON de widget por tenant

curl "https://analytics.bitnodo.net/v1/widget/config/23"

{
  "tenant": {
    "id": "23",
    "name": "Nombre del sitio"
  },
  "widget": {
    "enabled": true,
    "script_url": "https://analytics.bitnodo.net/widget/tracker.js",
    "public_key": "pk_live_xxxxxxxxx",
    "company_id": "ACCOUNT_ID_UNICO",
    "portal_id": "PORTAL_ID_OPCIONAL",
    "snippet": ""
  },
  "consent": {
    "enabled": true,
    "type": "modal",
    "storage": "localStorage",
    "text": "Este sitio utiliza herramientas de analisis de comportamiento para mejorar nuestros servicios y detectar oportunidades comerciales.",
    "terms_title": "Terminos de analisis de datos",
    "terms_body": "Este sitio utiliza Bitnodo Analytics para analizar el comportamiento de navegacion y detectar oportunidades comerciales."
  },
  "tracking": {
    "page_views": true,
    "scroll_tracking": true,
    "click_tracking": true
  }
}

<!-- Snippet extendido opcional generado por panel -->
<script src="https://analytics.bitnodo.net/widget/tracker.js"
  data-key="pk_live_xxxxxxxxx"
  data-tenant="23"
  data-api-base="https://analytics.bitnodo.net/api/v1"
  data-config-base="https://analytics.bitnodo.net"></script>

<!-- Modo manual (fallback) -->
<script src="https://analytics.bitnodo.net/widget/tracker.js"></script>
<script>
  window.BitnodoAnalytics.init({
    apiBase: "https://analytics.bitnodo.net/api/v1",
    companyId: "ACCOUNT_ID_UNICO",
    portalId: "PORTAL_ID_UNICO",
    widgetVersion: "1.0",
    captureFormContacts: true,
    legalMessage: "Este sitio usa analitica para mejorar la experiencia de usuario."
  });
</script>

Que monitorea el widget

El widget de Bitnodo Analytics esta pensado para operar como una capa de observacion del trafico web, similar al enfoque de herramientas de analytics. Detecta apertura de pagina, permanencia activa, navegacion interna y salida del visitante, y transforma esas acciones en eventos que la API puede almacenar y procesar.

Datos recolectados

La API recibe estos datos desde el widget para construir una vision operativa del trafico, comparable a una implementacion base de analytics orientada a visitas, procedencia, permanencia y navegacion dentro del sitio.

{
  "companyId": "ACCOUNT_ID_UNICO",
  "portalId": "PORTAL_ID_UNICO",
  "visitorId": "vtr_9j2k3lm...",
  "sessionId": "ses_c4d5e6f...",
  "eventType": "pageview",
  "pageUrl": "https://www.empresa.com/home",
  "referrer": "https://google.com/",
  "nextUrl": "https://www.empresa.com/precios",
  "screenActiveSeconds": 43,
  "timezone": "America/Santiago",
  "language": "es-CL",
  "widgetVersion": "1.0",
  "eventData": {
    "action": "https://www.empresa.com/contacto",
    "method": "POST",
    "fieldCount": 4,
    "lead": {
      "email": "cliente@empresa.com",
      "phone": "+56912345678",
      "emailField": "email",
      "phoneField": "telefono"
    }
  }
}

{
  "events": [
    {
      "companyId": "ACCOUNT_ID_UNICO",
      "portalId": "PORTAL_ID_UNICO",
      "visitorId": "vtr_9j2k3lm...",
      "sessionId": "ses_c4d5e6f...",
      "eventType": "pageview",
      "pageUrl": "https://www.empresa.com/home",
      "eventData": null
    },
    {
      "companyId": "ACCOUNT_ID_UNICO",
      "portalId": "PORTAL_ID_UNICO",
      "visitorId": "vtr_9j2k3lm...",
      "sessionId": "ses_c4d5e6f...",
      "eventType": "scroll_depth",
      "pageUrl": "https://www.empresa.com/home",
      "eventData": {"milestone":75}
    }
  ]
}

Ejemplo JavaScript — enviar eventos

const BASE = 'https://analytics.bitnodo.net/api/v1';

// Enviar evento individual
await fetch(`${BASE}/track`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    companyId:           'TU_ACCOUNT_ID',
    portalId:            'TU_PORTAL_ID',
    visitorId:           'vtr_' + Math.random().toString(36).slice(2),
    sessionId:           'ses_' + Date.now().toString(36),
    eventType:           'pageview',
    pageUrl:             window.location.href,
    referrer:            document.referrer,
    screenActiveSeconds: 0,
    timezone:            Intl.DateTimeFormat().resolvedOptions().timeZone,
    language:            navigator.language,
    widgetVersion:       '1.0'
  })
});

// Enviar batch de eventos acumulados
await fetch(`${BASE}/track/batch`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    events: [
      { companyId: 'TU_ACCOUNT_ID', portalId: 'TU_PORTAL_ID',
        visitorId: 'vtr_abc', sessionId: 'ses_001',
        eventType: 'scroll_depth', pageUrl: window.location.href,
        eventData: { milestone: 75 } },
      { companyId: 'TU_ACCOUNT_ID', portalId: 'TU_PORTAL_ID',
        visitorId: 'vtr_abc', sessionId: 'ses_001',
        eventType: 'link_click', pageUrl: window.location.href,
        eventData: { href: 'https://www.miempresa.com/precios' } }
    ]
  })
});

Pipeline de procesamiento de eventos

La API registra cada evento en la tabla events para desacoplar ingestion y procesamiento. El flujo queda preparado para workers de alto volumen.

Widget
  -> POST /track
          -> POST /track/batch (opcional)
  -> events (queue)
  -> processor interno / worker
  -> visit aggregation
  -> intent score
  -> alerts
  -> marketplace leads

Deteccion de intencion de compra

Bitnodo Analytics calcula un intent_score por sesion de visita (visit_id) usando los eventos del widget. Esto permite detectar en tiempo casi real visitas con alto interes comercial.

Visitas agregadas y sesiones

Cada evento se asocia a una sesion de visita (visit_id) y a dos identificadores del cliente: visitor_id (persistente) y session_id (rotacion cada 30 minutos). Esto mejora consistencia de scoring y agregacion multi-evento sin romper compatibilidad de endpoints existentes.

curl "https://analytics.bitnodo.net/api/v1/visits?limit=50" \
  -H "X-API-Key: TU_API_KEY"

{
  "items": [
    {
      "visit_id": "vst_98ad91",
      "portal_id": "PORTAL_ID",
      "ip": "186.10.25.44",
      "current_page": "https://www.empresa.com/precios",
      "pages": 4,
      "duration_seconds": 132,
      "intent_score": 9,
      "intent_level": "interested",
      "country": "Chile",
      "device_type": "mobile",
      "source_type": "google",
      "company": {
        "name": "Empresa Demo SpA",
        "domain": "empresa.cl",
        "confidence": 0.82
      },
      "created_at": "2026-03-11 15:40:12"
    }
  ]
}

Obtener visita actual (sesión específica)

Endpoint para obtener los detalles y tiempo en sitio de una sesión específica (visit_id). Útil para paneles que necesitan mostrar el tiempo en sitio de un usuario actualmente navegando, sin sumar sesiones históricas previas.

curl "https://analytics.bitnodo.net/api/v1/visits/vst_98ad91" \
  -H "X-API-Key: TU_API_KEY"

{
  "visit_id": "vst_98ad91",
  "portal_id": "PORTAL_ID",
  "ip": "186.10.25.44",
  "current_page": "https://www.empresa.com/precios",
  "first_page": "https://www.empresa.com/",
  "last_page": "https://www.empresa.com/precios",
  "pages": 4,
  "duration_seconds": 125,
  "active_seconds_total": 85,
  "event_count": 12,
  "intent_score": 9,
  "intent_level": "interested",
  "country": "Chile",
  "device_type": "mobile",
  "source_type": "google",
  "session_id": "sess_7f4e2a",
  "company": {
    "name": "Empresa Demo SpA",
    "domain": "empresa.cl",
    "confidence": 0.82
  },
  "created_at": "2026-03-11 15:40:12",
  "updated_at": "2026-03-11 15:42:17"
}

Deteccion de empresas visitantes (B2B Visitor Intelligence)

Bitnodo intenta identificar si una visita proviene de una red corporativa usando la IP publica, metadatos tecnicos y resolucion por dominio. Esta deteccion no identifica personas, solo contexto empresarial de red.

Alertas y monitoreo por API key

Para consultar alertas/eventos debes enviar la cabecera X-API-Key: TU_API_KEY.

curl "https://analytics.bitnodo.net/api/v1/alerts?limit=20" \
  -H "X-API-Key: TU_API_KEY"

{
          "event": "visit.company_detected",
          "portal_id": "PORTAL_ID",
          "visit_id": "VISIT_ID",
          "company_name": "Empresa Demo SpA",
          "company_domain": "empresa.cl",
          "intent_score": 14,
          "page_url": "/precios",
          "timestamp": "2026-03-11T18:20:00Z"
        }

Realtime interno (superadmin)

Para paneles operativos de tiempo real se recomienda usar el endpoint interno /internal/superadmin/realtime/overview con ventana corta y polling rapido. Este endpoint requiere cabecera X-Superadmin-Secret.

curl "https://analytics.bitnodo.net/internal/superadmin/realtime/overview?account_id=ACCOUNT_ID&portal_id=PORTAL_ID&since_seconds=30&active_window_seconds=20&active_by=session&limit=100" \
  -H "X-Superadmin-Secret: TU_SUPERADMIN_SECRET"

Ejemplo JavaScript — polling realtime interno

const BASE_INTERNAL = 'https://analytics.bitnodo.net/internal/superadmin';
const SUPERADMIN_SECRET = 'TU_SUPERADMIN_SECRET';

const params = new URLSearchParams({
  account_id: 'TU_ACCOUNT_ID',
  portal_id: 'TU_PORTAL_ID',
  since_seconds: '30',
  active_window_seconds: '20',
  active_by: 'session',
  limit: '100'
});

async function loadRealtimeOverview() {
  const url = `${BASE_INTERNAL}/realtime/overview?${params.toString()}`;
  const res = await fetch(url, {
    headers: {
      'X-Superadmin-Secret': SUPERADMIN_SECRET
    }
  });

  if (!res.ok) {
    throw new Error(`Realtime request failed: ${res.status}`);
  }

  const payload = await res.json();
  const data = payload.data || {};
  const realtime = data.realtime || {};

  // Metrica principal para tarjeta de "activos ahora"
  const activeNow = Number(realtime.active_visitors || 0);

  // Metricas secundarias utiles para diagnostico
  const sessions = Number(realtime.active_sessions || 0);
  const ips = Number(realtime.active_unique_ips || 0);

  console.log('[Realtime]', {
    activeNow,
    sessions,
    ips,
    activeBy: realtime.active_by,
    activeWindowSeconds: realtime.active_window_seconds
  });

  // Ejemplo: actualizar UI
  // document.querySelector('#active-now').textContent = String(activeNow);
  // document.querySelector('#active-sessions').textContent = String(sessions);
  // document.querySelector('#active-ips').textContent = String(ips);
}

async function pollRealtime() {
  try {
    await loadRealtimeOverview();
  } catch (error) {
    console.error(error);
  }
}

// Primera carga inmediata
pollRealtime();

// Polling recomendado: cada 5 segundos
setInterval(pollRealtime, 5000);

Ejemplo JavaScript — polling de alertas

const API_KEY = 'TU_API_KEY';
const BASE    = 'https://analytics.bitnodo.net/api/v1';

// Leer alertas recientes
const alertsRes = await fetch(`${BASE}/alerts?limit=20`, {
  headers: { 'X-API-Key': API_KEY }
});
const { items: alerts } = await alertsRes.json();

// Leer visitas con intent score
const visitsRes = await fetch(`${BASE}/visits?limit=50`, {
  headers: { 'X-API-Key': API_KEY }
});
const { items: visits } = await visitsRes.json();

// Polling cada 30 segundos para dashboard en tiempo real
setInterval(async () => {
  const res = await fetch(`${BASE}/alerts?limit=5`, {
    headers: { 'X-API-Key': API_KEY }
  });
  const data = await res.json();
  data.items.forEach(alert => {
    if (alert.intent_score >= 11) {
      console.log('Alta intencion:', alert.company_name, alert.intent_score);
    }
  });
}, 30_000);

Estadisticas agregadas para dashboard

El endpoint de overview evita procesar eventos crudos en clientes externos y entrega metricas listas para paneles operativos.

curl "https://analytics.bitnodo.net/api/v1/stats/overview" \
  -H "X-API-Key: TU_API_KEY"

{
  "visits_today": 124,
  "visits_yesterday": 110,
  "leads_today": 6,
  "high_intent_today": 9,
  "top_pages": ["/", "/servicios", "/precios"]
}

curl "https://analytics.bitnodo.net/api/v1/companies/detected?limit=50" \
  -H "X-API-Key: TU_API_KEY"

{
  "items": [
    {
      "company_name": "Empresa Demo SpA",
      "domain": "empresa.cl",
      "visits": 4,
      "last_visit": "2026-03-11 17:40:00",
      "highest_intent_score": 18
    }
  ]
}

Webhooks para integraciones externas

Puedes registrar webhooks por cuenta para recibir eventos operativos en tiempo real. Los intentos fallidos se reintentan automaticamente.

{
  "event": "lead.created",
  "portal_id": "PORTAL_ID",
  "visit_id": "VISIT_ID",
  "email": "cliente@empresa.com",
  "phone": "+56912345678",
  "page_url": "/contacto",
  "timestamp": "2026-03-11T17:20:00Z"
}

Lead Marketplace

El marketplace permite publicar oportunidades comerciales anonimizadas y desbloquear contacto completo solo despues de una compra valida del lead.

curl "https://analytics.bitnodo.net/api/v1/marketplace/leads?category=servicios%20legales&city=Santiago&min_intent_score=12&limit=20" \
  -H "X-API-Key: TU_API_KEY"

{
  "items": [
    {
      "lead_id": "ld_9231abf0",
      "category": "servicios legales",
      "sub_category": "abogado laboral",
      "city": "Santiago",
      "intent_score": 16,
      "estimated_budget_min": 300000,
      "estimated_budget_max": 800000,
      "lead_summary": "Empresa busca abogado laboral en Santiago. Nivel de interes 16. Presupuesto estimado entre $300.000 y $800.000.",
      "price": 7000,
      "created_at": "2026-03-11 18:40:00"
    }
  ]
}

curl -X POST "https://analytics.bitnodo.net/api/v1/marketplace/leads/ld_9231abf0/purchase" \
  -H "X-API-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"buyer_portal_id":"PORTAL_ID_COMPRADOR"}'

{
  "lead_id": "ld_9231abf0",
  "contact_name": "Rodrigo Perez",
  "contact_email": "rperez@empresa.cl",
  "contact_phone": "+56912345678",
  "company_name": "Comercial Andina SpA",
  "city": "Santiago"
}

curl -X POST "https://analytics.bitnodo.net/api/v1/marketplace/leads/ld_9231abf0/anonymize" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN"

Leads recuperables por API

Cuando un visitante envia un formulario y este contiene email y/o telefono validos, la API guarda esos datos en una entidad separada de leads para facilitar consulta comercial y atribucion de conversiones.

curl "https://analytics.bitnodo.net/api/v1/leads?limit=50" \
  -H "X-API-Key: TU_API_KEY"

curl "https://analytics.bitnodo.net/api/v1/leads?limit=50&portal_id=PORTAL_ID_UNICO&email=cliente@empresa.com&phone=%2B569&date_from=2026-03-01&date_to=2026-03-31" \
  -H "X-API-Key: TU_API_KEY"

{
  "items": [
    {
      "id": 12,
      "portal_id": "PORTAL_ID_UNICO",
      "visit_event_id": 301,
      "email": "cliente@empresa.com",
      "phone": "+56912345678",
      "page_url": "https://www.empresa.com/contacto",
      "form_id": "frm_k29a81",
      "form_name": "contacto",
      "source_event_type": "form_submit",
      "metadata": {
        "action": "https://www.empresa.com/contacto",
        "method": "POST",
        "page_identifier": "page_contacto",
        "field_count": 4,
        "lead_fields": {
          "email_field": "email",
          "phone_field": "telefono"
        }
      },
      "created_at": "2026-03-11 12:00:00"
    }
  ]
}

Sandbox de pruebas

El sandbox replica el comportamiento de la API de produccion de forma identica en validaciones y respuestas, pero no escribe nada en la base de datos. Ideal para integrar y probar tu cliente antes de usar credenciales reales.

1. Health check

curl "https://analytics.bitnodo.net/sandbox/v1/health"

{
  "status": "ok",
  "service": "bitnodo-analytics",
  "version": "v1",
  "mode": "sandbox",
  "timestamp": "2026-03-11T18:30:00+00:00"
}

2. Enviar evento de tracking

curl -s -X POST "https://analytics.bitnodo.net/sandbox/v1/track" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId":  "cualquier-account-id",
    "portalId":   "cualquier-portal-id",
    "visitorId":  "vtr_test_001",
    "sessionId":  "ses_test_001",
    "eventType":  "pageview",
    "pageUrl":    "https://www.miempresa.com/home"
  }'

{
  "ok": true,
  "message": "Event captured (sandbox — nothing stored)",
  "mode": "sandbox",
  "queued_event_id": "a3f8d1e2b4c9...",
  "visit_id": "e5b7f2a1c4d8...",
  "intent_score": 7,
  "intent_level": "normal",
  "echo": {
    "companyId": "cualquier-account-id",
    "portalId":  "cualquier-portal-id",
    "eventType": "pageview",
    "pageUrl":   "https://www.miempresa.com/home"
  }
}

3. Batch de eventos

curl -s -X POST "https://analytics.bitnodo.net/sandbox/v1/track/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "companyId": "cualquier-account-id",
        "portalId":  "cualquier-portal-id",
        "visitorId": "vtr_test_001",
        "sessionId": "ses_test_001",
        "eventType": "pageview",
        "pageUrl":   "https://www.miempresa.com/home"
      },
      {
        "companyId": "cualquier-account-id",
        "portalId":  "cualquier-portal-id",
        "visitorId": "vtr_test_001",
        "sessionId": "ses_test_001",
        "eventType": "scroll_depth",
        "pageUrl":   "https://www.miempresa.com/home",
        "eventData": {"milestone": 75}
      }
    ]
  }'

{
  "ok": true,
  "mode": "sandbox",
  "accepted": 2,
  "rejected": 0,
  "results": [
    {"ok": true, "event_index": 0, "queued_event_id": "c2a1b3d4..."},
    {"ok": true, "event_index": 1, "queued_event_id": "f5e6a7b8..."}
  ]
}

4. Login sandbox

curl -s -X POST "https://analytics.bitnodo.net/sandbox/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@ejemplo.com","password":"cualquierpassword"}'

{
  "mode": "sandbox",
  "user": {
    "id": "d4e5f6a7b8c9...",
    "email": "test@ejemplo.com",
    "full_name": "Sandbox User",
    "account_id": "a1b2c3d4e5f6...",
    "tenant_id":  "f6e5d4c3b2a1..."
  },
  "account": {
    "id":   "a1b2c3d4e5f6...",
    "name": "Sandbox Account",
    "plan": "pro",
    "api_key":    "bnk_sandbox_test_key",
    "public_key": "pk_sandbox_test",
    "secret_key": "sk_sandbox_test"
  },
  "access_token": "atk_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

5. Leer alertas / visitas / stats (ejemplo)

curl "https://analytics.bitnodo.net/sandbox/v1/alerts"
curl "https://analytics.bitnodo.net/sandbox/v1/visits"
curl "https://analytics.bitnodo.net/sandbox/v1/stats/overview"
curl "https://analytics.bitnodo.net/sandbox/v1/portals"

Ejemplo completo en JavaScript (fetch)

// 1. Hacer login en sandbox
const loginRes = await fetch('https://analytics.bitnodo.net/sandbox/v1/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email: 'test@ejemplo.com', password: 'test123' })
});
const { access_token } = await loginRes.json();

// 2. Enviar evento
await fetch('https://analytics.bitnodo.net/sandbox/v1/track', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    companyId:  'cualquier-account-id',
    portalId:   'cualquier-portal-id',
    visitorId:  'vtr_test_001',
    sessionId:  'ses_test_001',
    eventType:  'pageview',
    pageUrl:    window.location.href
  })
});

// 3. Consultar overview
const statsRes = await fetch('https://analytics.bitnodo.net/sandbox/v1/stats/overview');
const stats = await statsRes.json();
console.log(stats); // { visits_today: 124, leads_today: 6, ... mode: "sandbox" }

Salud de sistema y control de trafico

{
  "status": "ok",
  "service": "bitnodo-analytics",
  "version": "v1",
  "timestamp": "2026-03-11T18:30:00Z"
}

{
  "portal_id": "PORTAL_ID",
  "widget_detected": true,
  "last_event_at": "2026-03-11 16:10:11",
  "events_last_24h": 1243,
  "visits_last_24h": 301
}

Lineamientos de Desarrollo y Compatibilidad

Bitnodo Analytics evoluciona con foco en estabilidad del contrato publico. La arquitectura interna puede cambiar para mejorar rendimiento, escalabilidad y seguridad, manteniendo compatibilidad con integraciones existentes.

Errores HTTP comunes

Seguridad y cumplimiento

• Passwords protegidas con Argon2id.
• Tokens y API keys guardados hashados en base de datos.
• Aislamiento por cuenta (multi-tenant).
• Consultas SQL preparadas (PDO).
• Aviso legal integrado en el widget.
• Captura de datos de contacto solo al enviar formularios.