Ground Control API

The Ground Control API allows external applications to authenticate, validate licenses, and trigger downloads for Bellweather Studios plugins.

Open Ground Control Dashboard

Authentication

All Ground Control endpoints require a valid API key passed via the Authorization header.

POST /api/ground-control/auth
Content-Type: application/json

{
  "apiKey": "your-api-key",
  "product": "BwsPressure"
}

Returns a session token for subsequent requests.

License Validation

Validate a license key and check its status.

POST /api/ground-control/licenses
Content-Type: application/json
Authorization: Bearer <session-token>

{
  "licenseKey": "BWST-XXXX-XXXX-XXXX-XXXX",
  "product": "BwsPressure",
  "machineId": "unique-machine-identifier"
}

Response:

{
  "valid": true,
  "licenseType": "PERSONAL",
  "product": "BwsPressure",
  "expiresAt": null
}

Plugin Download

Request a signed download URL for a product installer.

GET /api/ground-control/download/bws-pressure
Authorization: Bearer <session-token>

Returns a temporary signed URL for the installer binary. URLs expire after 15 minutes.

Error Codes

Code	Status	Description
401	Unauthorized	Missing or invalid API key / session token
403	Forbidden	License not valid for this product
404	Not Found	Product or license not found
429	Rate Limited	Too many requests — back off and retry