API Reference

The M-Kestrel API is organized around REST. It accepts JSON request bodies, returns JSON responses and uses standard HTTP status codes. All requests must be made over HTTPS to https://kestrel.marinkino.ru.

Authentication

Authenticate with a workspace token in the Authorization header. Tokens are created in the dashboard under Settings → API keys and can be scoped to ingest-only or read-only access.

Authorization: Bearer kp_live_••••••••••••••••

Errors & limits

StatusMeaning
401Missing or invalid token
403Token lacks the required scope
422Payload failed validation
429Rate limit exceeded — 1,000 requests/s per workspace by default

POST/v2/points

Accepts a single point or an array of up to 5,000 points. Returns 202 Accepted once points are durably queued.

FieldTypeDescription
assetstringAsset identifier, created on first write
tsRFC 3339Measurement time; defaults to server time
lat, lonnumberOptional WGS 84 position
metricsobjectUp to 256 numeric or boolean values

GET/v2/assets/{asset}/points

Returns points for an asset in a time range. Use from, to, metrics and bucket (e.g. 5m) to downsample.

curl "https://kestrel.marinkino.ru/v2/assets/truck-0142/points?from=2026-11-18T00:00:00Z&bucket=15m" \ -H "Authorization: Bearer $KP_TOKEN"

GET/v2/assets

Lists assets in the workspace with their last known position and metrics. Supports cursor pagination via starting_after.

GET/v2/stream

Upgrades to a WebSocket and pushes new points for the assets or groups passed in subscribe. Connections are closed after 24 hours; reconnect with the last cursor to resume without gaps.