Telemetry API

Real-time data ingestion, event tracking, and analytics endpoints for Aevum News platform integrations. Secure, low-latency, and enterprise-grade.

All Systems Operational • Global Regions Active

Uptime (30d)

99.98%

▲ 0.02% vs last month

Avg Latency

42ms

▼ 8ms improvement

Requests / min

14,205

Global aggregate

Error Rate

0.03%

Within threshold

Core Endpoints

Method	Path	Description	Rate Limit
GET	/v2/events/track	Submit telemetry events (pageview, click, error, custom)	1000 req/min
POST	/v2/events/batch	Bulk upload up to 500 events per request	100 req/min
GET	/v2/ingestion/status	Check queue depth and processing lag	60 req/min
POST	/v2/segments/create	Define audience segment for targeting	50 req/min
DELETE	/v2/events/purge	Compliance: GDPR/CCPA data deletion	Auth restricted

Authentication

API Key Header

Authorization: Bearer aevum_live_sk_7x9m2p4q8r1t5v8w

All requests require a valid API key via the Authorization header. Keys are scoped to telemetry:write or telemetry:read. Never expose secret keys in client-side code.

Code Examples

cURL

Python

JavaScript

# Track a single pageview event
curl -X GET https://api.aevumnews.com/v2/events/track \
  -H "Authorization: Bearer aevum_live_sk_7x9m2p4q8r1t5v8w" \
  -H "Content-Type: application/json" \
  -d '{"event":"pageview","url":"/article/quantum-leap","user_id":"usr_8821"}'
                

import requests

headers = {
    "Authorization": "Bearer aevum_live_sk_7x9m2p4q8r1t5v8w",
    "Content-Type": "application/json"
}

payload = {
    "event": "article_complete",
    "duration_ms": 4200,
    "user_id": "usr_8821"
}

response = requests.post("https://api.aevumnews.com/v2/events/track", json=payload, headers=headers)
print(response.status_code, response.json())
                

// Client-side event tracking (use public key)
async function trackEvent(event, data = {}) {
    const res = await fetch(`https://api.aevumnews.com/v2/events/track`, {
        method: "POST",
        headers: {
            "Authorization": "Bearer aevum_pub_k9x2m4p7",
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ event, ...data })
    });
    return res.json();
}

trackEvent("video_play", { duration: 15000 });
                

Ingestion Activity

Recent Requests

LIVE

Timestamp	Method	Path	Status	Latency	Region