Product and Design

Databox for Developers

Gasper Vidovic on February 25, 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 a senior UI/UX designer at Databox. Also a traveler, lawyer & icon enthusiast.
You may also like...
Read more

Is Your Website Easy To Understand? Test it With Qualitative Data Using Amazon MTurk

Use these scripts, screenshots and strategies on Amazon Mechanical Turk to get real feedback in 3 hours or less

Analytics   |  Jul 24

Read more

How to Organize your Databoards With Tags and Favorites

Navigate between all your reports in a clean, well-structured way to avoid information overload

Product and Design   |  Jul 21

Read more

Introducing Databoards: How to Build KPI Reports Perfectly Optimized for Every Device

With Databox, you can now build a report once and view it on your desktop browser, a TV screen or in our native mobile app.

Product and Design   |  Jun 8