Back to Main Site

API Documentation

Interactive API explorer with real-time testing

99.9%
Uptime
<100ms
Avg Response Time
50K+
Requests/Second
v2.0
API Version

Event Service API

Real-time event processing and analytics service

GET /api/events

Retrieve the latest 100 events from the system with filtering and pagination support.

Response
[
  {
    "id": 1,
    "user_id": "user_001",
    "event_type": "page_view",
    "timestamp": "2025-07-04T10:34:14Z",
    "context": {
      "page": "homepage",
      "referrer": "google.com"
    },
    "metadata": {
      "ip": "192.168.1.1",
      "user_agent": "Mozilla/5.0..."
    }
  },
  {
    "id": 2,
    "user_id": "user_002",
    "event_type": "button_click",
    "timestamp": "2025-07-04T10:35:22Z",
    "context": {
      "button_id": "subscribe_btn",
      "page": "pricing"
    },
    "metadata": {
      "session_id": "sess_abc123"
    }
  }
]
POST /api/events

Create a new event in the system with custom context and metadata.

Request Body
{
  "user_id": "user_123",
  "event_type": "purchase",
  "context": {
    "product_id": "prod_456",
    "amount": 99.99,
    "currency": "USD"
  },
  "metadata": {
    "source": "mobile_app",
    "version": "2.1.0"
  }
}
Response
{
  "id": 4,
  "status": "created",
  "timestamp": "2025-07-04T10:36:45Z"
}

Feature Store API

Centralized feature management system for ML models

GET /api/features

List all available features in the feature store with metadata and versioning info.

Response
[
  {
    "id": 1,
    "name": "user_age",
    "feature_group": "demographics",
    "data_type": "int",
    "description": "User's age in years",
    "version": "1.0",
    "created_at": "2025-07-04T08:30:00Z",
    "updated_at": "2025-07-04T08:30:00Z"
  },
  {
    "id": 2,
    "name": "purchase_frequency",
    "feature_group": "behavioral",
    "data_type": "float",
    "description": "Average purchases per month",
    "version": "2.1",
    "created_at": "2025-07-03T14:20:00Z",
    "updated_at": "2025-07-04T09:15:00Z"
  }
]
POST /api/features

Register a new feature in the feature store with versioning and lineage tracking.

Request Body
{
  "name": "user_lifetime_value",
  "feature_group": "user_metrics",
  "data_type": "float",
  "description": "Predicted lifetime value of the user",
  "transformation": "sum(purchases.amount) * retention_rate",
  "dependencies": ["purchase_history", "retention_model"]
}
Response
{
  "id": 4,
  "status": "created",
  "version": "1.0",
  "feature_group": "user_metrics",
  "created_at": "2025-07-04T10:38:12Z"
}

Health Check API

Monitor system health and service status

GET /api/health

Check the health status of all services and dependencies.

Response
{
  "status": "healthy",
  "timestamp": "2025-07-04T10:40:00Z",
  "services": {
    "database": {
      "status": "healthy",
      "type": "sqlite",
      "response_time_ms": 2
    },
    "cache": {
      "status": "healthy",
      "type": "redis",
      "memory_usage": "12.5MB"
    },
    "ml_service": {
      "status": "healthy",
      "models_loaded": 3,
      "avg_inference_time_ms": 45
    }
  },
  "system": {
    "cpu_usage": "15%",
    "memory_usage": "32%",
    "uptime_hours": 720
  }
}