Skip to main content

LightDB Stream

LightDB Stream Device Service definitions over CoAP.

How to use guides:

Interface

MethodDescriptionPathContent Format
POSTSend 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:

AttributeDescriptionDefault
t or ts or time or timestampTimestamp of the datapointnow()

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