v1/streams
Use the streams web service to manage data streams and data points. You can also use the streams web service to upload a batch of data points to streams using an XML or CVS file. See Direct device uploads.
URI
http://<hostname>/ws/v1/streams
Formats
| Method | Format | Description |
|---|---|---|
| GET | /ws/v1/streams | Get a summary of the streams APIs. |
| GET, POST | /ws/v1/streams/inventory | List, create, or modify data streams. |
| GET, PUT, DELETE | /ws/v1/streams/inventory/{stream_id} | Get, create, modify, or delete a specific data stream. |
| GET | /ws/v1/streams/inventory?category=carrier | Get carrier usage data for devices. |
| GET, PUT, DELETE | /ws/v1/streams/ | Get, create, or remove data streams. |
| POST | /ws/v1/streams/history | Add one or more data points to a data stream |
| GET, DELETE | /ws/v1/streams/history/{stream_id} | Get or delete the history for a data stream. |
| GET | /ws/v1/streams/rollups/{stream_id} | Get roll-up information for a data stream. |
| GET | /ws/v1/streams/history/{device_id}/carrier/{sim_id}/usage/{usage_id} | Get carrier usage data for a device. |
| GET | /ws/v1/streams/inventory?category=data | Get data streams reported by devices. |
| GET | /ws/v1/streams/inventory?category=metrics | Get health metrics streams reported by devices. |
| GET | /ws/v1/streams/inventory?category=management | Get management streams recorded for devices. |
Stream fields
id
Steam identifier.
description
Stream description.
type
Data type of the stream:
- integer
- long
- float
- double
- string
- binary
value
Current value of the data stream.
geoposition
timestamp
Date and time the current value was set.
server_timestamp
Date and time the current value was received.
stream_units
Units for the data.
forward_to
List of additional streams to forward data to when received.
History fields
id
Identifier of the data point in the stream history.
stream_id
Stream identifier of the history data.
Roll-up fields
stream_id
Stream identifier for the roll-up data.
Parameters
| Name | Type | Description |
|---|---|---|
| start_time | timestamp | Start time (inclusive) in ISO 8601 or epoch (long). |
| end_time | timestamp | End time (exclusive) in ISO 8601 or epoch (long). |
| timeline | string | Timestamps to use in the request: client or server. The default is client. |
| cursor | string | Cursor to get the next page of devices. Omit on initial call. |
| size | integer | Number of items to return. The maximum and default is 1000. |
| order | string | Return streams ordered by ID (asc | desc). The default is ascending (asc). |
| category | string | Return streams for the specified category: data, metrics, management, or carrier. If you do not use the category parameter, streams for all categories are returned. |
| timezone | string | Timezone in which to calculate rollups. Applies only to rollups with intervals of day or longer. |
| interval | string | Rollup interval: half, hour, day, week, or month. The default is hour. |
| method | string | Rollup method: sum, average, min, max, count, standarddev. The default is average. |