VA3ODC Network

System Integration APIs

Choose between standard REST JSON polling or direct JavaScript script-tag integration for client-side scripts that requires zero CORS configuration.

REST JSON API (Fetch / cURL / Backend Polling)

GET /api.php

Runs parallel ICMP diagnostics on all hosts and returns a live JSON payload with CORS headers.

GET /api.php?id={index}

Diagnoses a single host. Replace {index} with the host ID (e.g., 0 to 7).

GET /api.php?list=1

Retrieves configured host labels, IPs, and description metadata without triggering pings.

JS / JSONP Zero-CORS Client API (Direct <script> Tag Integration)

Use this endpoint in any external website or client-side .js file. Because it loads as a standard script, it completely bypasses browser CORS restrictions.

SCRIPT /api-jsonp.php

Inject as a script tag. Automatically sets window.VA3ODC_STATUS and triggers a va3odc:status custom event.

JSONP /api-jsonp.php?callback={functionName}

Executes your custom JavaScript callback function with the status payload (supports ?id={index} and ?list=1 filters).

Quick Client Integration Example:

<script src="https://dstar.tor.solosoft.ca/online/api-jsonp.php?callback=myHandler"></script>
<script>
  function myHandler(data) {
    if (data.success) {
      console.log("Online Systems:", data.results.filter(h => h.online).length);
      console.log("Live Network Status:", data.results);
    }
  }
</script>