Integration Docs — AnalyticsHub

Integration Guide

Send telemetry from any application to AnalyticsHub using simple HTTP POST calls. Works with any language — curl, JavaScript, C#, Python, and more.

Swagger UI Download for AI agents

Getting an API Key

1. Log in and navigate to Applications (/apps).

2. Register your application and create an API key — the full key is shown once at creation time. Copy it immediately.

3. Use the placeholder ah_live_YOUR_KEY in the examples below and replace it with your actual key.

Authentication

Every collect request authenticates via an apiKey field in the JSON request body. No HTTP headers or query-string parameters required.

{
  "apiKey": "ah_live_YOUR_KEY",
  ...
}

Environments

Include the optional environment field to tag telemetry by deployment environment. Accepted values: Production, Staging, QA, Dev. Default: Production.

{
  "apiKey": "ah_live_YOUR_KEY",
  "environment": "Staging"
}

Endpoints

Base URL: https://bizeyes.securitasmachina.org

POST

/api/collect/session

Start a user session

Request body:

{
  "apiKey": "ah_live_YOUR_KEY",
  "userId": "optional-user-id",
  "browser": "Chrome",
  "os": "Windows",
  "device": "Desktop",
  "country": "US",
  "city": "New York",
  "referrer": "https://example.com",
  "utmSource": "newsletter",
  "utmMedium": "email",
  "utmCampaign": "spring2026",
  "environment": "Production"
}

Response:

{ "sessionToken": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" }

POST

/api/collect/pageview

Record a page view

Request body:

{
  "apiKey": "ah_live_YOUR_KEY",
  "path": "/home",
  "title": "Home Page",
  "sessionToken": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "referrer": "https://google.com",
  "environment": "Production"
}

POST

/api/collect/event

Record a custom event

Request body:

{
  "apiKey": "ah_live_YOUR_KEY",
  "name": "button.clicked",
  "category": "ui",
  "label": "signup-cta",
  "value": 1.0,
  "sessionToken": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "properties": "{\"plan\":\"pro\"}",
  "environment": "Production"
}

POST

/api/collect/exception

Record an application exception

Request body:

{
  "apiKey": "ah_live_YOUR_KEY",
  "type": "NullReferenceException",
  "message": "Object reference not set to an instance of an object",
  "stackTrace": "   at MyApp.Foo() in Foo.cs:line 42",
  "severity": "Error",
  "isHandled": false,
  "environment": "Production"
}

POST

/api/collect/request

Record an HTTP request metric

Request body:

{
  "apiKey": "ah_live_YOUR_KEY",
  "method": "GET",
  "path": "/api/products",
  "statusCode": 200,
  "durationMs": 45.2,
  "environment": "Production"
}

Quick-Start Snippets

# 1. Create a session
SESSION=$(curl -s -X POST https://bizeyes.securitasmachina.org/api/collect/session \
  -H 'Content-Type: application/json' \
  -d '{"apiKey":"ah_live_YOUR_KEY","browser":"curl","environment":"Dev"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['sessionToken'])")

# 2. Send a page view
curl -s -X POST https://bizeyes.securitasmachina.org/api/collect/pageview \
  -H 'Content-Type: application/json' \
  -d '{"apiKey":"ah_live_YOUR_KEY","path":"/home","sessionToken":"'$SESSION'","environment":"Dev"}'

For AI Agents (Claude)

A plain-Markdown version of this guide optimised for AI consumption is available at:

GET https://bizeyes.securitasmachina.org/docs/llms.txt Download

Terse integration recipe:

Obtain an API key at /apps — shown once, starts with ah_

POST /api/collect/session → extract sessionToken

POST /api/collect/pageview and /api/collect/event with the token

Optional: /api/collect/exception and /api/collect/request