XpectraFlow API
Ingest, query and annotate engineering telemetry over HTTP and gRPC.
XpectraFlow stores high-rate engineering telemetry — drone flights, propulsion tests, spacecraft downlink — and gives you charts, events and a command log over the top of it. This is the reference for talking to it from your own systems.
Start here
Quickstart
Key, experiment, dataset, data, back out again — about ten minutes, entirely with curl.
Core concepts
Organizations, experiments, datasets, channels — what the nouns mean before you touch an endpoint.
Authentication
Create an API key in the console and send it as x-api-key, on HTTP and gRPC alike.
API conventions
One error shape, one request id, no deletes. Read once, and the reference gets shorter.
How data gets in
Two paths, and which one you want depends almost entirely on rate.
| Path | Good for | Roughly |
|---|---|---|
| HTTP append | Scripts, backfills, slow sensors | up to a few hundred points/s |
| gRPC streaming | Sustained sensor feeds | 10 kHz, validated to 20 kHz |
Both start the same way — register a stream — and share one data model, so moving between them later changes the transport and nothing else.
If you are not sure, start with HTTP. It is the only one you can drive with
curl.
Getting commands out
XpectraFlow does not transmit to your vehicle. When an operator issues a command, we POST a signed notification to an HTTPS endpoint you registered, and your own system owns the last mile — the radio, the interlocks, the responsibility.
How command delivery works explains the model, the two interlocks that gate it, and what your receiver has to do.
The reference
Organised by resource — one page per noun, with every operation on it, a
runnable curl, and the response it actually returns.
Experiments
The container everything hangs off.
Datasets
Runs, and appending rows to one.
Channels
What ch_N means and why it is the only address that works.
Events
Annotate a run, including live.
Commands
Dispatch, acknowledge, arm.
Webhooks
Where commands are delivered, and how they are signed.
API keys
List and revoke. Creating one is console-only.