Navigate to: Integrations -> REST
Swagger API documentation: https://platform.lobaro.com/api
Access Tokens
All API calls must be authenticated with an access token. Access tokens can be managed on the REST Integration page.
Each token has a list of roles assigned to it.
Token roles:
- network-server: Allows to write device data. Required for LoRaWAN Network Server Integrations.
Add the Token into the HTTP request Header:
- Field:
Authorization - Value:
Bearer eyJhbGciOiJIU...
Filter query parameters
Filters parameters can be appended to some requests in the form of <type>:<field>=<op>:<value> e.g. f:createdAt=gt:<timestamp> to filter by createdAt date.
<type>is either "f" for fields, or "fa" for arrays (e.g. to search in tags)<field>is the field to be queried and specified for each endpoint separately. Common fields are e.g. "id", "createdAt", "updatedAt"<value>is the value to be queried. The Value must be URL encoded e.g. a timestamp might look likegt:2000-01-01T02:37:00%2B01:00<op>is the operator between the field and the value, see list of allowed operators below.
<op> must be one of the following operators:
| In Query | Meaning | Valid for <type> |
|---|---|---|
eq | = | f |
lte | <= | f |
lt | < | f |
gte | >= | f |
gt | > | f |
like | SQL LIKE operator | f |
ilike | SQL ILIKE operator | f |
| contains | array field contains all of the values | fa |
| containedby | array field is contained by by the list of values | fa |
| overlap | array field and list of values overlap | fa |
If no operator is given the default eq operator will be used for fields and contains for arrays.
Example requests
Get data from a single devices by address or tag
Find relevant device(s):
- By Address (printed on the device and QR Code):
- By Tag:
The result contains an "data.id" field that is used to query the data, just replace {deviceId} with the ID from the first query and adjust the date and limit parameters as needed:
Additional Endpoints:
Donwlink creation:
POST: /devices/{devId}/downlik (replace {devId} with an device id)
URL Query Params:
type: chose one of "fw", "config" "raw" or "lorawan" depending on your downlink. Also see: Downlinks and for lorawan downlinks also see LoraWan Downlinks
Returns: Status 200 ok and nothing in success or error status code and information about the error in the body
JSON Body:
The Body contains the downlink content. See Downlinks and for lorawan downlinks also see LoraWan Downlinks for Details.