Developer reference

Send a reading.
Verify the response.

POST a JSON payload to /api/telemetry/ingest using your device API key. Use stable metric names that match your datastream configuration.

Request example

A small payload is enough to begin.

POST /api/telemetry/ingest
Authorization: Bearer <DEVICE_API_KEY>
Content-Type: application/json

{
  "data": {"temperature": 24.8, "humidity": 58.9},
  "units": {"temperature": "°C", "humidity": "%"}
}

A successful batch response includes ok, inserted and device_id. Confirm that the inserted count matches the expected readings.

Alternatively, send a readings array containing metric_name, metric_value and optional unit fields. Successfully stored telemetry updates device activity; malformed requests do not.

HTTP 400 indicates an invalid payload, 401 indicates a missing or invalid device key, and 405 indicates an unsupported method.