Product and Design

Databox for Developers

Avatar 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
Avatar
Gasper Vidovic is Director of Product at Databox. Also a traveler, lawyer & icon enthusiast.
You may also like...
Read more

Now in Databox: Monitor All of Your Important Business Metrics From One Screen

With the all-new Metrics screen, it only takes a few clicks for anyone on your team to create a personalized view of all the business metrics that matter.

Product and Design   |  Oct 23

Read more

8 Proven Strategies for Converting Free Trial Users to Paying Customers

We asked pros from 60 SaaS businesses to share tips for converting trial users to paid customers. Here’s how they’ve improved their paid activation rates.

Product and Design   |  Jun 26

Read more

Inside the Design of the New Databox Logo

We recently launched a new logo. Here’s why we did it and the thought that went into the design.

Product and Design   |  May 7