🛰️ Enterprise Core v2.0.0

Platform API Reference

Welcome to the official programmatic documentation for the NIGCOMSAT Beam Integrity & Interference Platform. This backend powers high-availability satellite telemetry streaming, anomaly detection via hybrid machine-learning, and hyperbolic TDOA ground station multilateration.

Authentication & Security Scopes

Secured endpoints require a valid commercial enterprise API key provided via request headers or dependency injection. Enterprise routes enforce verification flags such as telemetry:read or geo:estimate.

System Status

PUBLIC

Returns active transponder counts, database ingestion latency, and ML classifier status.

GET /api/stats JSON Response

{
  "active_transponders": "04 / 04",
  "ingestion_latency_ms": 12,
  "ml_classifier": "ONLINE",
  "status": "NOMINAL"
}

Fetch Recent Telemetry

SECURED

Retrieves recent RF carrier telemetry logs for real-time chart rendering and historical tracking.

GET /api/telemetry/recent?limit=15 Requires Scope: telemetry:read

Sample Response Structure

{
  "authorized_client": "NOC-Primary-Command",
  "tier": "Enterprise",
  "data": [
    {
      "timestamp": 1775085234.12,
      "transponder_id": "NIGCOMSAT-1R-TP1",
      "carrier_power_dbm": -65.5,
      "snr_db": 32.5,
      "frequency_ghz": 12.45
    }
  ]
}

Ingest Telemetry Frame

CORE INGESTION

Submits a live RF telemetry frame for immediate hybrid anomaly evaluation, TimescaleDB persistence, and ITSM dispatch if compromised.

POST /api/telemetry/ingest Content-Type: application/json

Request Payload Example

{
  "transponder_id": "NIGCOMSAT-1R-TP1",
  "carrier_power_dbm": -64.2,
  "snr_db": 31.8,
  "frequency_ghz": 12.45
}

Fetch Incident Alerts

INCIDENTS

Retrieves recent security breaches and power spike warnings for the NOC incident feed console.

GET /api/alerts/recent?limit=10

TDOA Geolocation Estimate

ENTERPRISE TIER

Computes hyperbolic multilateration coordinates from ground station time-difference-of-arrival (TDOA) delay metrics.

POST /api/geolocation/estimate Requires Scope: geo:estimate

Example Request Body

{
  "station_alpha_ns": 12.4,
  "station_beta_ns": 18.9,
  "station_gamma_ns": 7.2
}

Rural Hubs & Community Vouchers

COMMUNITY GATEWAYS

Endpoints for monitoring remote VSAT community gateways and generating prepaid internet access vouchers.

GET

/api/rural/gateways

Lists active status, signal strengths, and bandwidth usage for all community nodes.

POST

/api/rural/gateways/heartbeat

Ingests operational heartbeats from remote rural gateways.

POST

/api/rural/vouchers/generate

Generates subsidized or prepaid data access vouchers tied to specific regional gateway IDs.