README.md

Dev Setup

This project requires node and npm. If you don't already have it installed then please visit: https://nodejs.org/en/ and download your recommended setup.

If you don't already have nodemon or gulp installed then 'npm -g install nodemon' and/or 'npm -g install gulp' is required.

Step 1: In your terminal of choice using the CLI -> git clone https://github.com/Brilliant-Labs/bl-cloud-v2.git

Step 2: cd into your bl-cloud-v2 directory

Step 3: npm i (this is a shortcut for npm install)

Step 4: gulp

Step 5: In a new terminal: nodemon index.js

Step 6: In your browser: http://localhost:3000/

---

Brilliant Labs Cloud API

• HTTP Communication
  • Overview
  • Headers
  • Examples
• WS Communication
  • Overview
  • Examples
• MQTT Communication
  • Overview
  • Examples
• Variables
  • Overview
  • Create Variable
  • Delete Variable
  • Set Variable
  • Get Variable
  • Get All Variables
• Charts
  • Overview
  • Create Chart
  • Delete Chart
  • Delete Chart Data
  • Add Data Point
  • Get Data Point
  • Get Chart Data
  • Get Chart List
• Feeds
  • Overview
  • Create Feed
  • Delete Feed
  • Add Feed Data
  • Get Feed Data
  • Delete Feed Data

HTTP Communication

Overview

Communicating to the Brilliant Labs Cloud can be done through a GET https request, whereas the content of the body is a json string with a given command. The primary use case for communicating through https is for devices that do not have the capabilities of communicating through a websocket connection. The server only accepts connections over SSL.

**The URL for https requests: **: https://cloud.brilliantlabs.ca/api

Headers

The required headers:

Header	Value
Content-Type	application/json

Examples

Command Line cURL

curl -d '{"cmd":"CREATE_VARIABLE", "key":"gsqfr6DsDWfGhn4og5RHNQTA3hFE","value":5, "name":"TestVariable"}' -H "Content-Type: application/json" -X GET  https://cloud.brilliantlabs.ca/api

response

{"meta":{"revision":0,"created":1563162485390,"version":0},"results":{"TestVariable":5}} 

If you don't have cURL installed, you can check how to do so here

You can also use an API development tool like Postman or Insomnia

WS Communication

Overview

Communicating to the Brilliant Labs Cloud can be done through a Websocket Connection, whereas the message content is a json string with a given command. The primary use case for communicating through a websocket on a device is to have improved communication speeds for real time applications. The server only accepts websocket connections over wss.

Please note that the API described in this document also works with the websocket server. Use the same commands and format described later in the document as you would with the https requests body.

**The URL for websocket connections is: **: wss://cloud.brilliantlabs.ca/wsapi

Examples

If you visit https://www.websocket.org/echo.html, you can test out the websocket API.

The image bellow demonstrates an example using WebSocket.org to communicate with the server.

MQTT Communication

Overview

Communicating to the Brilliant Labs Cloud can be done through a MQTT Connection. Messages are published to a target topic whereas the message content is a json string with a given command, and the topic is the project API key. Server responses can be received by subscribing to the topic of your projects API key with the appending of '-rsp'. Publish to -> XXXXXX_API_KEY_XXXXXX, Subscribe to -> XXXXXX_API_KEY_XXXXXX-rsp.

Currently the MQTT broker only accepts tcp connections on port 1883.

Examples

You can test the MQTT communication using a chrome application called MQTTLens.

Here is an example using MQTT Lens to set the value of a variable over MQTT:

First we create the connection:

Second, we subscribe to the API key + '-rsp', and publish the command to the API key.

We can see that we received the confirmation that the command was successful.

Variables

Overview

Variables are meant to be used to store simple values and flags to a given API key, like one would do while coding let myVariable = 23. Variables are not intended to be used for large data sets, however variables can hold objects and all data types. Variables must all have unique names. Variables can be created, deleted, set and read from a device using the API key. Please read carefully throughout this section to catch all the details needed while implementing this API in your application or embedded system.

Command	Parameters	Type	Description
CREATE_VARIABLE	name	String	Name of the variable to create.
	value	Any	Value to initialize the variable to.
DELETE_VARIABLE	name	String	Name of the variable to erase.
SET_VARIABLE	name	String	Name of the variable to save.
	value	Any	Value to set the variable to.
GET_VARIABLE	name	String	Name of the variable to read.
GET_ALL_VARIABLES

Create Variable

Command that creates a variable that can be set and read.

Command: CREATE_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
value*	Any	Value to initialize the variable with.

*Paramate 'value' is not required, will be initialized as null if not specified.

Example 1 (No Value)

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "CREATE_VARIABLE",
    "name": "Test"
}

Response:

{
    "meta":{
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": null
    }
}

Example 2 (Value Provided)

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "CREATE_VARIABLE",
    "name": "Test",
    "value": 12345678
}

Response:

{
    "meta":{
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": 12345678
    }
}

Delete Variable

Command that erases a stored variable.

Command: DELETE_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	String	Name of the variable to erase.

Example

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "DELETE_VARIABLE",
    "name": "Test"
}

Response:

{
    "result": true,
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    }
}

Set Variable

Command that sets the value of a variable.

Command: SET_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
value	Any	Value to set the variable to.

Example

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "SET_VARIABLE",
    "name": "Test",
    "value": 87654321
}

Response:

{
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": 87654321
    }
}

Get Variable

Command that gets the value of a variable.

Command: GET_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
value	any	Name of the variable to read.

Example

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_VARIABLE", 
    "name": "Test"
}

Response

{
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": 87654321
    }
}

Get All Variable

Command that retrieves all variables.

Command: GET_ALL_VARIABLES

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command

Example

Request

{
  "key": "XXXXXXXXXXXXXX",
  "cmd": "GET_ALL_VARIABLES"
}

Response

{
    "meta": {
        "revision": 0,
        "created": 1567996872756,
        "version": 0,
        "updated": 1569251454138
    },
    "results": {
        "Humidity": 43,
        "Temperature": 26,
        "Test Name": "Heat"
    }
}

Charts

Overview

Charts are intended to be used to hold big data sets with the goal of being able to visualize the data as a chart on the Brilliant Labs Cloud web client. Chart commands can also be used to simply hold big data sets, without necessarily wanting to visualise the data on a chart. Charts can be created, delete, set and read. Please read carefully throughout this section to catch all the details needed while implementing this API in your application or embedded system.

Five different chart types can be create:

1. Line
2. Bar
3. Pie
4. Scatter
5. Histogram

Create Chart

This command creates a Bar, Pie, Scatter, Line or Histrogram Chart.

Command: CREATE_CHART || NEW_CHART

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the chart to add data to.
type	string	Type of chart to create. ['BAR', 'PIE', 'SCATTER', 'LINE', 'HISTOGRAM']
start	number	Start range of the histogram chart. (Histogram)
end	number	Stop range of the histogram chart. (Histogram)

Example 1 (Line Chart, Bar, Pie, Scatter)

Request

{ 
    "key": "XXXXXXXXXXXXXXXX",
    "cmd": "CREATE_CHART",
    "name": "Temperature Chart",
    "type": "LINE"
}

Response

{
    "result":{
        "created": 1563162485390,
        "entries": 0,
        "id": "cu2495n20cn20c",
        "name": "Temperature Chart",
        "type": "LINE"
    }
}

Example 2 (Histogram)

Request

{ 
    "key": "XXXXXXXXXXXXXXXX",
    "cmd": "CREATE_CHART",
    "name": "Age Distribution",
    "type": "HISTOGRAM",
    "start": 0,
    "end": 120
}

Response

{
    "result": {
        "id": "0cwejc09wej0rv",
        "created": 1563162485390,
        "entries": 0,
        "name": "Age Distribution",
        "type": "HISTOGRAM",
        "start": 0,
        "end": 120
    }
}

Delete Chart

This function erases a chart.

Command: DELETE_CHART || ERASE_CHART || REMOVE_CHART

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the chart to add data to.

Example

Request

{
    "key": "XXXXXXXXXXXXXXXX",
    "cmd": "DELETE_CHART",
    "name": "Temperature Chart"
}

Response

{
    "result": true,
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    }
}

Delete Chart Data

This command erases the data associated with a chart.

Command: DELETE_CHART_POINT || DELETE_DATA_POINT || DELETE_DATA

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the chart to get data from.
index	number	Index of the Data Point to delete. Do not include this parameter if you want to retrieve the latest data point
range	object	Range [start, end], inclusive to delete.
last	number	Delete the last X amount of values
first	number	Delete the first X amount of values
all	bool	true -> delete all data

Example 1 (Line Chart Delete 1 Entry 5 Entries)

INITIAL DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    },  
    {
        "y": 30
    },  
    {
        "y": 39
    },  
    {
        "y": 28
    }
]

Request

{
  "key": "XXXXXXXXXXXXXXXX",
  "cmd": "DELETE_DATA_POINT",
  "name": "Temperature Chart",
  "index": 3
}

Response

{
    "result": true
}

RESULTING DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    },  
    {
        "y": 39
    },  
    {
        "y": 28
    }
]

Example 2 (Line Chart Delete All 5 Entries)

INITIAL DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    },  
    {
        "y": 30
    },  
    {
        "y": 39
    },  
    {
        "y": 28
    }
]

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"DELETE_DATA_POINT",
    "name": "Temperature Chart",
    "all": true
}

Response

{
    "result": true
}

RESULTING DATA:

[
  
]

Example 3 Line Chart Delete Range (5 Entries)

INITIAL DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    },  
    {
        "y": 30
    },  
    {
        "y": 39
    },  
    {
        "y": 28
    }
]

Request

{
    "key": "XXXXXXXXXXXXXXXX",
    "cmd": "DELETE_CHART_DATA",
    "name": "Temperature Chart",
    "range": [1,3]
}

Response

{
    "result": true
}

RESULTING DATA:

[
    {
        "y": 39
    },
    {
        "y": 28
    }
]

Example 4 Line Chart Delete Last 3 (5 Entries)

INITIAL DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    },  
    {
        "y": 30
    },  
    {
        "y": 39
    },  
    {
        "y": 28
    }
]

Request

{
    "key": "XXXXXXXXXXXXXXXX",
    "cmd": "DELETE_CHART_DATA",
    "name": "Temperature Chart",
    "last": 3
}

Response

{
    "result": true
}

RESULTING DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    }
]

Example 5 Line Chart Delete Firs 3 (5 Entries)

INITIAL DATA:

[
    {
        "y": 34
    },
    {
        "y": 32
    },  
    {
        "y": 30
    },  
    {
        "y": 39
    },  
    {
        "y": 28
    }
]

Request

{
    "key": "XXXXXXXXXXXXXXXX",
    "cmd": "DELETE_CHART_DATA",
    "name": "Temperature Chart",
    "last": 3
}

Response

{
    "result": true
}

RESULTING DATA:

[
    {
        "y": 39
    },
    {
        "y": 28
    }
]

Add Chart Point

This commands adds a data point to a chart.

Command: ADD_DATA || ADD_DATA_POINT || ADD_CHART_POINT

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the chart to add data to.
point	string	Name of the data point. (Pie, Bar)
value	number	Value of the data point. (Pie, Line, Bar)
x	number	Value of the X coordinate. (Scatter, Histogram)
y	number	Value of the Y coordinate. (Scatter, Histogram)

Example 1 (Pie, Bar)

INITIAL STORED DATA:

[
    {
        "point": "Mortgage",
        "value": 540.23
    },
    {
        "point": "Travel",
        "value": 250
    },  
    {
        "point": "Utilities",
        "value": 320.99
    }
]  

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"ADD_CHART_POINT",
    "name": "Monthly Budget Pie Chart",
    "point": "Food",
    "value": 234.23
}

Response

{
    "result":{
        "id": "0cwejc09wej0rv",
        "created": 1563162485390,
        "entries": 4,
        "name": "Monthly Budget Pie Chart",
        "type": "PIE"
    },
    "meta":{
        "revision":0,
        "created":1563162485390,
        "version":0
    }
}

RESULTING DATA:

[
    {
        "point": "Mortgage",
        "value": 540.23
    },
    {
        "point": "Travel",
        "value": 250
    },  
    {
        "point": "Utilities",
        "value": 320.99
    },
    {
        "point": "Food",
        "value": 234.23
    }
]  

Example 2 (Line)

INITIAL DATA:

[
    {
        "value": 540.23
    },
    {
        "value": 250
    },  
    {
        "value": 320.99
    }  
]

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"ADD_CHART_POINT",
    "name": "Monthly Budget Pie Chart",
    "value": 234.23
}

Response

{
"result":{
    "id": "0cwejc09wej0rv",
    "created": 1563162485390,
    "entries": 4,
    "name": "Stock Price",
    "type": "LINE"
  },
  "meta":{
    "revision":0,
    "created":1563162485390,
    "version":0
  }
}

RESULTING DATA:

[
    {
        "value": 540.23
    },
    {
        "value": 250
    },  
    {
        "value": 320.99
    },
    {
        "value": 234.23
    } 
]

Example 1 (Pie, Bar)

DATA:

[
    {
        "point": "Mortgage",
        "value": 540.23
    },
    {
        "point": "Travel",
        "value": 250
    },  
    {
        "point": "Utilities",
        "value": 320.99
    }  
]

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"ADD_CHART_POINT",
    "name": "Monthly Budget Pie Chart",
    "point": "Food",
    "value": 234.23
}

Response

{
    "result":{
        "id": "0cwejc09wej0rv",
        "created": 1563162485390,
        "entries": 4,
        "name": "Monthly Budget Pie Chart",
        "type": "PIE"
    },
    "meta":{
        "revision":0,
        "created":1563162485390,
        "version":0
    }
}

RESULTING DATA:

[
    {
        "point": "Mortgage",
        "value": 540.23
    },
    {
        "point": "Travel",
        "value": 250
    },  
    {
        "point": "Utilities",
        "value": 320.99
    },
    {
        "point": "Food",
        "value": 234.23
    } 
]

Example 3 (Scatter)

INTIAL DATA:

[
    {
        "x": 43,
        "y": -23
    },
    {
        "x": 32,
        "y": -22
    },  
    {
        "x": 43,
        "y": -33
    }  
]

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"ADD_CHART_POINT",
    "name": "Humidity in function of temperature chart",
    "x": 78,
    "y": 23
}

Response

{
"result":{
        "id": "0cwejc09wej0rv",
        "created": 1563162485390,
        "entries": 4,
        "name": "Stock Price",
        "type": "LINE"
    },
    "meta":{
        "revision":0,
        "created":1563162485390,
        "version":0
    }
}

RESULT DATA:

[
    {
        "x": 43,
        "y": -23
    },
    {
        "x": 32,
        "y": -22
    },  
    {
        "x": 43,
        "y": -33
    },
    {
        "x": 78,
        "y": 23
    }    
]

Get Data Point

This commands gets the value of a data point from a chart.

Command: GET_DATA || GET_DATA_POINT || GET_CHART_POINT

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the chart to get data from.
index	number	Index of the Data Point to retrieve. Do not include this parameter if you want to retrieve the latest data point
range	object	Range [start, end], inclusive.
last	number	Get the last X amount of values
first	number	Get the first X amount of values

Example 1 (Latest Value)

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_DATA_POINT",
    "name": "Temperature"
}

Response

{
    "results": {
        "entry": 5,
        "timestamp": 1581368571501,
        "id": "1581368571501jjhlg18nzk6gy0mzx",
        "value": 23
    }
}

Example 2 (Specific Index)

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_DATA_POINT",
    "name": "Temperature",
    "index": 33
}

Response (Latest Value)

{
    "results": {
        "entry": 33,
        "timestamp": 1581368571501,
        "id": "1581368571501jjhlg18nzk6gy0mzx",
        "value": 27
    }
}

Example 3 (Specific Range)

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_DATA_POINT",
    "name": "Temperature",
    "range": [2,4]
}

Response

{
    "results": [
        {
            "entry": 2,
            "timestamp": 1581368569082,
            "id": "1581368569082jjhlg18nzk6gy0l4q",
            "value": 23
        },
        {
            "entry": 3,
            "timestamp": 1581368569837,
            "id": "1581368569837jjhlg18nzk6gy0lpp",
            "value": 23
        },
        {
            "entry": 4,
            "timestamp": 1581368570894,
            "id": "1581368570894jjhlg18nzk6gy0mj2",
            "value": 23
        }
    ]
}

Example 4 (Last X values)

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_DATA_POINT",
    "name": "Temperature",
    "last": 3
}

Response

{
    "results": [
        {
            "entry": 3,
            "timestamp": 1581368569837,
            "id": "1581368569837jjhlg18nzk6gy0lpp",
            "value": 23
        },
        {
            "entry": 4,
            "timestamp": 1581368570894,
            "id": "1581368570894jjhlg18nzk6gy0mj2",
            "value": 23
        },
        {
            "entry": 5,
            "timestamp": 15813685690342,
            "id": "15813685690342jhlg18nzk6gy0l4q",
            "value": 24
        }

    ]
}

Example 4 (First X values)

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_DATA_POINT",
    "name": "Temperature",
    "first": 3
}

Response

{
    "results": [
        {
            "entry": 1,
            "timestamp": 1581368569837,
            "id": "1581368569837jjhlg18nzk6gy0lpp",
            "value": 23
        },
        {
            "entry": 2,
            "timestamp": 1581368570894,
            "id": "1581368570894jjhlg18nzk6gy0mj2",
            "value": 23
        },
        {
            "entry": 3,
            "timestamp": 15813685690342,
            "id": "15813685690342jhlg18nzk6gy0l4q",
            "value": 24
        }

    ]
}

Get Chart Data

Get all the data from a specific chart.

Command: GET_CHART_DATA

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the chart to get data from.

Example

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_CHART_DATA",
    "name": "Temperature"
}

Response

{
    "meta": {
        "entries": 5,
        "name": "Temperature",
        "created": 1581368521020,
        "id": "1581368521020jjhlg18nzk6gxzk1o",
        "type": "LINE"
    },
    "results": [
        {
            "entry": 1,
            "timestamp": 1581368568262,
            "id": "1581368568262jjhlg18nzk6gy0khy",
            "value": 23
        },
        {
            "entry": 2,
            "timestamp": 1581368569082,
            "id": "1581368569082jjhlg18nzk6gy0l4q",
            "value": 23
        },
        {
            "entry": 3,
            "timestamp": 1581368569837,
            "id": "1581368569837jjhlg18nzk6gy0lpp",
            "value": 23
        },
        {
            "entry": 4,
            "timestamp": 1581368570894,
            "id": "1581368570894jjhlg18nzk6gy0mj2",
            "value": 23
        },
        {
            "entry": 5,
            "timestamp": 1581368571501,
            "id": "1581368571501jjhlg18nzk6gy0mzx",
            "value": 23
        }
    ]
}

Get Chart List

Retrieve a list of all the charts for a given project.

Command: GET_CHART_LIST

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command

Example

Request

{
  "key": "XXXXXXXXXXXXXX",
  "cmd": "GET_CHART_LIST"
}

Response

{
    "results": [
        {
            "created": 1581368521020,
            "id": "1581368521020jjhlg18nzk6gxzk1o",
            "name": "Temperature Logging",
            "type": "LINE",
            "entries": 23
        },
        {
            "created": 1581368537965,
            "id": "1581368537965jjhlg18nzk6gxzx4d",
            "name": "Budget",
            "type": "PIE",
            "entries": 12
        },
        {
            "created": 1581386679806,
            "id": "1581386679806jjhlg18nzk6h8srge",
            "name": "Age Spread",
            "type": "HISTO",
            "entries": 44
        },
        {
            "created": 1581386730575,
            "id": "1581386730575jjhlg18nzk6h8tumn",
            "name": "Test Results",
            "type": "SCATTER",
            "entries": 123
        }
    ]
}

Create Variable

Command that creates a variable that can be set and read.

Command: CREATE_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
value*	Any	Value to initialize the variable with.

*Paramate 'value' is not required, will be initialized as null if not specified.

Example 1 (No Value)

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "CREATE_VARIABLE",
    "name": "Test"
}

Response:

{
    "meta":{
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": null
    }
}

Example 2 (Value Provided)

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "CREATE_VARIABLE",
    "name": "Test",
    "value": 12345678
}

Response:

{
    "meta":{
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": 12345678
    }
}

Delete Variable

Command that erases a stored variable.

Command: DELETE_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	String	Name of the variable to erase.

Example

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "DELETE_VARIABLE",
    "name": "Test"
}

Response:

{
    "result": true,
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    }
}

Set Variable

Command that sets the value of a variable.

Command: SET_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
value	Any	Value to set the variable to.

Example

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "SET_VARIABLE",
    "name": "Test",
    "value": 87654321
}

Response:

{
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": 87654321
    }
}

Get Variable

Command that gets the value of a variable.

Command: GET_VARIABLE

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
value	any	Name of the variable to read.

Example

Request

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "GET_VARIABLE", 
    "name": "Test"
}

Response

{
    "meta": {
        "revision": 0,
        "created": 1563162485390,
        "version": 0
    },
    "result": {
        "Test": 87654321
    }
}

Feeds

Overview

Feeds are used to store any kind of data for a given project. Feeds must all have unique names. Feeds can be created, deleted, set and read from a device using the API key. Please read carefully throughout this section to catch all the details needed while implementing this API in your application or embedded system.

Command	Parameters	Type	Description
CREATE_FEED	name	String	Name of the feed to create.
DELETE_FEED	name	String	Name of the feed to erase.
ADD_FEED_DATA	name	String	Name of the feed to add the data to.
	value	Any	Value to add to the feed.
GET_FEED_DATA	name	String	Name of the feed to read data from.
DELETE_FEED_DATA

Create Feed

Command that creates a new feed.

Command: CREATE_FEED || NEW_FEED

Parameters	Type	Description
key	string	Project API key
cmd	string	Command
name	string	Name of the new feed

Example

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "CREATE_FEED",
    "name": "Test Feed"
}

Response:

{
  "results": {
      "name": "Test Feed",
      "entries": 0,
      "created": 1597770883444,
      "id": "1597770883444shvfasngkwke07j3w4"
  }
}

Delete Feed

Command that deletes a feed.

Command: DELETE_FEED || NEW_FEED

Parameters	Type	Description
key	string	Project API key.
cmd	string	Command
name	string	Name or ID of the feed to be deleted

Example 1 (Name)

Request:

{
    "key": "XXXXXXXXXXXXXX",
    "cmd": "DELETE_FEED",
    "name": "Test Feed"
}

Response:

{
    "meta": {
        "version": 0,
        "revision": 0,
        "created": 1597772087920
    },
    "results": true
}

Example 2 (ID)

Request:

{
    "key": "XXXXXXXXXXXXXX",  
    "cmd": "DELETE_FEED",
    "name": "1597770883444shvfasngkwke07j3w4"
}

Response:

{
    "meta": {
        "version": 0,
        "revision": 0,
        "created": 1597772087920
    },
    "results": true
}

Add Feed Data

This commands adds a data point to a feed.

Command: ADD_FEED_DATA

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the feed to add data to.
value	any	Value of the data point.

• Maximum of 1024 characters.

Example

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"ADD_FEED_DATA",
    "name": "Test Feed",
    "value": 234.23
}

Response

{
  "result": {
    "id": "159804470398243kbv25yke4qk166",
    "created": 1598044703982,
    "entries": 6,
    "name": "Test Feed",
    "value": 234.23
  },
  "meta": {
    "revision": 0,
    "created": 1598044703982,
    "version": 0
  }
}

Get Feed Data

This commands gets data from a feed.

Command: GET_FEED_DATA

Parameters	Type	Description
key	string	Project API Key
cmd	string	Command
name	string	Name of the feed to add data to.
index	number	Index of the Data Point to get. (Do not include this parameter if you want to retrieve the latest data point)
range	object	Range [start, end], inclusive to get.
period	object	Timestamp range [start, end], to get
last	number	Get the last X amount of values
first	number	Get the first X amount of values
all	bool	true -> get all data (max 500 data points)

• Maximum of 500 characters.

Example 1 (Get last 3 data points)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed",
    "last": 3
}

Response

{
  "meta": {
    "entries": 6,
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": [
    {
      "timestamp": 1597841715330,
      "id": "1597841715330173hvzl35ke1dpa4i",
      "value": "Test 4"
    },
    {
      "timestamp": 1597841716997,
      "id": "1597841716997173hvzl35ke1dpbet",
      "value": "Test 5"
    },
    {
      "timestamp": 1597841718731,
      "id": "1597841718731173hvzl35ke1dpcqz",
      "value": "Test 6"
    }
  ]
}

Example 2 (Get first 3 data points)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed",
    "first": 3
}

Response

{
  "meta": {
    "entries": 6,
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": [
    {
      "timestamp": 1597840593672,
      "id": "1597840593672173hvzkw6ke1d18nc",
      "value": "Test 1"
    },
    {
      "timestamp": 1597841711952,
      "id": "1597841711952173hvzl35ke1dp7ip",
      "value": "Test 2"
    },
    {
      "timestamp": 1597841713575,
      "id": "1597841713575173hvzl35ke1dp8rr",
      "value": "Test 3"
    }
  ]
}

Example 3 (Get all data points (returns a maximum of 500 data points))

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed",
    "all": true
}

Response

{
  "meta": {
    "entries": 6,
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": [
    {
      "timestamp": 1597840593672,
      "id": "1597840593672173hvzkw6ke1d18nc",
      "value": "Test 1"
    },
    {
      "timestamp": 1597841711952,
      "id": "1597841711952173hvzl35ke1dp7ip",
      "value": "Test 2"
    },
    {
      "timestamp": 1597841713575,
      "id": "1597841713575173hvzl35ke1dp8rr",
      "value": "Test 3"
    },
    {
      "timestamp": 1597841715330,
      "id": "1597841715330173hvzl35ke1dpa4i",
      "value": "Test 4"
    },
    {
      "timestamp": 1597841716997,
      "id": "1597841716997173hvzl35ke1dpbet",
      "value": "Test 5"
    },
    {
      "timestamp": 1597841718731,
      "id": "1597841718731173hvzl35ke1dpcqz",
      "value": "Test 6"
    }
  ]
}

Example 4 (Get most recent data point)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed"
}

Response

{
  "meta": {
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": {
    "timestamp": 1597841718731,
    "id": "1597841718731173hvzl35ke1dpcqz",
    "value": "Test 6"
  }
}

Example 5 (Get data from a specific range)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed",
    "range": [2, 5]
}

Response

{
  "meta": {
    "entries": 6,
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": [
    {
      "timestamp": 1597841713575,
      "id": "1597841713575173hvzl35ke1dp8rr",
      "value": "Test 3"
    },
    {
      "timestamp": 1597841715330,
      "id": "1597841715330173hvzl35ke1dpa4i",
      "value": "Test 4"
    },
    {
      "timestamp": 1597841716997,
      "id": "1597841716997173hvzl35ke1dpbet",
      "value": "Test 5"
    },
    {
      "timestamp": 1597841718731,
      "id": "1597841718731173hvzl35ke1dpcqz",
      "value": "Test 6"
    }
  ]
}

Example 5 (Get data from a timestamp range)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed",
    "period": [1597841713575, 1597841716997]
}

Response

{
  "meta": {
    "entries": 6,
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": [
    {
      "timestamp": 1597841713575,
      "id": "1597841713575173hvzl35ke1dp8rr",
      "value": "Test 1"
    },
    {
      "timestamp": 1597841715330,
      "id": "1597841715330173hvzl35ke1dpa4i",
      "value": "Test 1"
    },
    {
      "entry": 5,
      "timestamp": 1597841716997,
      "id": "1597841716997173hvzl35ke1dpbet",
      "value": "Test 1"
    }
  ]
}

Example 6 (Specific Index)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"GET_FEED_DATA",
    "name": "Test Feed",
    "index": 3
}

Response

{
  "meta": {
    "entries": 6,
    "name": "Test Feed",
    "created": 1597840540277,
    "id": "1597840540277173hvzkw6ke1d03g6"
  },
  "results": {
    "timestamp": 1597841713575,
    "id": "1597841713575173hvzl35ke1dp8rr",
    "value": "Test 4"
  }
}

Delete Feed Data

Command to delete data from a feed.

Command: DELETE_FEED_DATA

Parameters	Type	Description
key	string	Project API key.
cmd	string	Command.
name	string	Name of the feed to delete data from.
index	number	Index value of the data point to delete. (Do not include this parameter or any other following parameters if you want to delete the most recent data point)
range	object	Range [start, end], inclusive to delete.
last	number	Remove the last X data points.
first	number	Remove the first X data points.
all	bool	true -> Delete all data points.

Example 1 (Delete the last 3 (most recent) data points)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd": "DELETE_FEED_DATA",
	"name": "Test Feed",
	"last": 3
}

Response

{
  "meta": {
    "entries": 3,
    "name": "Test Feed",
    "created": 1598030709094,
    "id": "1598030709094gq1vr76dke4i82na"
  },
  "results": true
}

Example 2 (Delete the first 3 (oldest) data points)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd": "DELETE_FEED_DATA",
	"name": "Test Feed",
	"first": 3
}

Response

{
  "meta": {
    "entries": 3,
    "name": "Test Feed",
    "created": 1598030709094,
    "id": "1598030709094gq1vr76dke4i82na"
  },
  "results": true
}

Example 3 (Delete all Data Points)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"DELETE_FEED_DATA",
    "name": "Test Feed",
    "all": true
}

Response

{
  "meta": {
    "entries": 0,
    "name": "Test Feed",
    "created": 1598030709094,
    "id": "1598030709094gq1vr76dke4i82na"
  },
  "results": true
}

Example 4 (Delete most recent value)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"DELETE_FEED_DATA",
    "name": "Test Feed"
}

Response

{
  "meta": {
    "entries": 5,
    "name": "Test Feed",
    "created": 1598030709094,
    "id": "1598030709094gq1vr76dke4i82na"
  },
  "results": true
}

Example 5 (Index Range)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"DELETE_FEED_DATA",
    "name": "Test Feed",
    "range": [1, 3]
}

Response

{
  "meta": {
    "entries": 3,
    "name": "Test Feed",
    "created": 1598030709094,
    "id": "1598030709094gq1vr76dke4i82na"
  },
  "results": true
}

Example 5 (Specific Index)

Request

{
    "key":"XXXXXXXXXXXXXXXX",
    "cmd":"DELETE_FEED_DATA",
    "name": "Test Feed",
    "index": 3
}

Response

{
  "meta": {
    "entries": 5,
    "name": "Test Feed",
    "created": 1598030709094,
    "id": "1598030709094gq1vr76dke4i82na"
  },
  "results": true
}