LightDB Stream
LightDB Stream Device Service definitions over CoAP.
How to use guides:
Interface
Method | Description | Path | Content Format |
---|---|---|---|
POST | Send data | /.s/{path=\*\*} | JSON/CBOR |
path
can be any valid URI sub path. Ex:/.s/env/temperature
/.s/location
To demonstrate the operations here, let's imagine that we are tracking an asset using an IoT device. The location data from our device is going to be periodically pushed to LightDB Stream.
Parameters and attributes that are known:
Attribute | Description | Default |
---|---|---|
t or ts or time or timestamp | Timestamp of the datapoint | now() |
The body can be a JSON/CBOR object or a single value in the following formats:
boolean
float
integer
string
You can also send a batch request by sending an array at the root level with different timestamps:
$ coap --path /.s/position -m POST --psk-id deadbeef-id@my-project-id --psk supersecret --host coap.golioth.io -b "[{\"ts\": 1626362266059, \"latitude\": 37.75, \"longitude\" : -122.57, \"speed\": 5 }, {\"ts\": 1626362276059, \"latitude\": 38.75, \"longitude\" : -123.57, \"speed\": 10 }]" --format json