Product and Design

Databox for Developers

Gasper Vidovic on February 25, 2016 (last modified on June 27, 2016) • 3 minute read

Announcing Databox for Developers!

Ask and you shall receive. After oodles of excited inquiries, we’re pumped to announce the launch of Databox for Developers!

With this launch, we’ve made it really easy for you to push custom data to Databox. Now you, our awesome developer community, can find all the information you need, all in one place, to connect any data source to Databox and build your own beautiful mobile KPI dashboards. That means you’ll be able to deliver addictive, attention-grabbing visualizations, alerts and notifications, and take advantage of all the power in the Databox platform with just a few lines of code.

So what’s the scoop?

First and foremost, there’s no special developer’s account needed. Just visit developers.databox.com and you’ll find everything you need to get started. With our simple REST API and SDKs, just pick your favorite language (Java, PHP, Ruby, Node.js, GO, or Python) and you’ll be able to connect any data source in minutes. Really.

Databox Developers

Want a quick preview?

Here’s a quick overview of what it takes to get started as a Databox Developer. And of course, all the details are available on our Databox for Developers site.

1. Create a Databox account

If you don’t have your Databox account yet, you can sign-up here. You don’t need a special developers account, so if you already have one, you’re ready to skip to the next step.

2. Get your Token

You’ll need an API token to send us data.  Every account comes with a pre-assigned (‘Default’) token which can be found in the Databox Designer web app under ‘Data Manager’ > ‘Active data connections’ as shown below:

Token

Your token is also shown during account setup when you choose to push your own data instead of selecting a connector.

3. Send your data

Ok, now you can send us data. Here are a few different ways to do that:

  • (recommended) using our SDKs;
  • through the Terminal Panel in the Databox Designer or
  • directly from a command line with executing a cURL as shown below:

curl https://push.databox.com 
-u YOUR_TOKEN_GOES_HERE: 
-X POST 
-H 'Content-Type: application/json' 
-d '{
  "data":[
    {
      "$sales": 123000
    }
  ]
}'

The example above will create a metric called ‘Sales’ under the ‘Default’ data source. This is a very basic example, you can also push additional information, such as a timestamps and attributes.

4. See your data

Now you need to create a visualization for the data you just sent us. We present data on so called ‘Datacards.’ They consist of individual visualizations (e.g. pie chart, table, line chart, etc.) called ‘Datablocks.’

So first create a new Datacard, open the Datablocks tab on the left side and drag a ‘Number’ Datablock to your Datacard.

drag-bignumber

In properties panel on the right, select the appropriate data source (‘Default’ in this case) and the metric you have just sent (‘Sales’).

Databox - Right panel

Voila, that’s it! Now just download the Databox Mobile app, log in with your credentials, and check out your very own beautiful new KPI dashboard!

If you get stuck at any point, please don’t hesitate to reach out to us — we’d be happy to help!

About the author
Gasper Vidovic is Director of Product at Databox. Also a traveler, lawyer & icon enthusiast.

Get practical strategies that drive consistent growth

Read some
You may also like...
Read more

NEW – Databox Performance Screen 

Get quick access to the Metrics and Goals that matter to you the most.

Product and Design   |  Apr 24

Read more

Get Insights on Your Top KPIs with the Metric Detail Page and the Weekly Metric Performance Digest

Dig deeper into each and every metric you are tracking.

Product and Design   |  Nov 18 2022

Read more

New: Connect Your Dashboards Together in Databox Using Looped Databoards

You can now tell the full story of your performance from a variety of sources and viewpoints.

Product and Design   |  Oct 18 2021