Spec

API Reference

HTTP endpoints exposed by the LogStrata controller for external query and integration.

Ingress IP Blocklist Management

Query or manually add addresses to the dynamic firewall blocklist.

GET/api/v1/blocklist

Auth Required

Retrieves the complete array of currently blocked client IP addresses with their remaining lease durations.

Example Response:

{
  "status": "success",
  "blocked_ips": [
    {
      "ip": "104.22.45.1",
      "reason": "DDoS threshold violation",
      "expires_in_sec": 1420
    }
  ]
}

POST/api/v1/blocklist

Auth Required

Manually add an IP address to the firewall blocklist.

Payload Schema:

{
  "ip": "198.51.100.42",
  "reason": "Manual operator block",
  "duration_sec": 3600
}

Controller Metrics Feed

GET/api/v1/metrics

Public Feed

Returns current telemetry aggregated by the LogStrata controller daemon for active policy monitoring.

Example Response:

{
  "cluster_context": "minikube-logstrata-prod",
  "uptime_seconds": 158240,
  "telemetry": {
    "aggregate_rps": 18.2,
    "error_rate_pct": 0.45,
    "p95_latency_ms": 118,
    "target_deployment": "main-frontend",
    "active_replicas": 3,
    "min_replicas_lock": null
  }
}