API reference

All requests go to https://api.edge-telemetry.de over TLS 1.2 or above. Authentication is a project token passed as a bearer credential. Tokens are scoped to a single project and can be rotated without redeploying anything.

Authentication

curl -sS https://api.edge-telemetry.de/v1/status \
  -H "Authorization: Bearer $PROJECT_TOKEN"

Endpoints

POST /v1/ingest
Submit a batch of samples. Body is newline-delimited JSON, max 4 MB per request.
POST /v1/ingest/compressed
As above, gzip or zstd encoded. Set Content-Encoding accordingly.
GET /v1/health
Liveness probe. Returns 200 and an empty body.
GET /v1/status
Component health as JSON. Used by this status page.
POST /v1/tokens/rotate
Issue a replacement project token. The previous token stays valid for 24 hours.

Rate limits

60 requests per minute per project token, measured over a sliding window. Exceeding the limit returns 429 with a Retry-After header. Bulk operations count once per call, not once per item.

Errors

Errors are returned as JSON with a stable code field. The HTTP status carries the class of failure; the code identifies the specific condition.

{
  "error": {
    "code": "token_expired",
    "message": "The project token is no longer valid.",
    "request_id": "7f3c1a9e"
  }
}

Quote request_id when contacting support; it is retained for 30 days.