The API.
Pull your measured sensor data straight into your own systems, live.
1 · What it does
The Augos API lets you retrieve measurement data for your electricity, water, manufacturing and sensing devices, for both actual and virtual measurement points. It is how you feed live readings into your own tools rather than working from a file.
2 · Getting access
Contact support@augos.io with the measurement points you want registered. Augos issues a unique authorisation token, which goes in the header of every request as a bearer token.
3 · Retrieve measurement data
Data requests are an HTTP GET, with the token in the Authorization header:
GET https://live.augos.io/api/v1/analysis/data/raw
Authorization: Bearer <token>The main parameters:
| Parameter | Description |
|---|---|
pointID | The unique ID of the measurement point |
startDateUTC | UTC start date, yyyy/mm/dd HH:mm |
endDateUTC | UTC end date, yyyy/mm/dd HH:mm |
interval | mi one-minute, or hh half-hourly |
summed | 0 for all data fields, 1 for summarised only |
4 · The response
Data returns in JSON, and the fields vary with the type of measurement point, so a temperature sensor and a state sensor return the shape that fits each.
5 · Rate limits
Up to 48 data requests per day per measuring point, and up to 10,080 records per request. A higher-limit subscription is available if you need more.
6 · Access and permissions
The API obeys the same point-level permissions as the platform. A token only returns the points it is registered for, so it cannot reach data a person is not cleared for. See Roles & access.