Developer Reference

Telemetry & API Docs

Integrate with the CyCity Quantum Web Standard telemetry network. Monitor node status, validate licenses, and download daemon binaries.

Authentication

All API endpoints require authentication via Bearer token or License Key headers, depending on the endpoint context.

Authorization: Bearer <JWT_TOKEN>
X-CQWS-License: <LICENSE_KEY>

POST

/api/license/ping

Called by the `cqws_daemon.ko` kernel module every 5 minutes to report telemetry and validate license standing.

Request Body (JSON)

{
  "licenseKey": "CQWS-XXXX-XXXX-XXXX",
  "status": "active" | "error" | "offline",
  "version": "1.0.4",
  "hostname": "node-us-east-1",
  "os": "Ubuntu 22.04 LTS"
}

Response (200 OK)

{
  "valid": true,
  "action": "continue",
  "nextPing": 300
}

GET

/api/download/installer

Downloads the zero-knowledge encrypted `cqws_installer.sh` payload. Requires a valid license key.

Query Parameters

`license_key` (string, required): The enterprise license key.

Response (200 OK - application/octet-stream)

Binary stream of the installer payload.

GET

/api/admin/telemetry

Retrieves aggregated telemetry for the admin dashboard. Requires Admin JWT Bearer token.

Response (200 OK)

{
  "totalNodes": 142,
  "activeNodes": 140,
  "packetsDropped": 1045239,
  "alerts": []
}