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.
Errors & limits
| Status | Meaning |
|---|---|
401 | Missing or invalid token |
403 | Token lacks the required scope |
422 | Payload failed validation |
429 | Rate 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.
| Field | Type | Description |
|---|---|---|
asset | string | Asset identifier, created on first write |
ts | RFC 3339 | Measurement time; defaults to server time |
lat, lon | number | Optional WGS 84 position |
metrics | object | Up 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.
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.