Integrating with a third-party platform in 5 minutes

Before you begin

This guide assumes that you have a Cloud Connector and sensors available. If not, please consider ordering a sensor kit.

Connect the Cloud Connectors

Go right ahead and plug your Cloud Connector into a power outlet or use PoE. When the white cloud shines a solid white, you’re connected and good to go!

 

cloud-connector.png

DT Studio

DT Studio is a developer console where you can manage, among other things, sensors, projects, and Service Accounts.

Start by opening a new tab, navigate to https://studio.disruptive-technologies.com, and sign in with your user credentials. 

By default, all sensors are sent to the organizations' Inventory project when shipped. Navigate to this or another project, by clicking on Manage Projects in the left and selecting the project name. Make sure the selected project contains sensors.

Then select Sensors & Cloud Connectors in the left menu, and all Cloud Connectors and sensors in the selected project will appear.

project-with-sensors.jpg

Identify a sensor

To identify the sensor you have in front of you, press the Identify a Sensor button to the right of the search field at the top. Then, touch a sensor, and the detailed view of the sensor will pop up.

Every time you press the sensor, you should see an animation behind the sensor icon, and the last-seen timestamp is updated.

sensor-touch.png

Reliably streaming events using Data Connectors

A Data Connector reliably pushes real-time sensor data to the endpoints of 3rd party services. The Data Connector is similar to webhooks in that it sends HTTPS POST requests to an endpoint of your choice.

Set up a Data Connector and push data

Click on Data Connectors on the menu and then Create new.

data-connector-menu.jpg

For this demonstration, we’ll use the free public messaging service dweet.io. Dweet.io is a free service that allows anyone to make an HTTP POST request to a URL with an arbitrary JSON payload and look for real-time changes. In other words, it fits our purposes perfectly.

dweet.io and Disruptive Technologies

Disruptive Technologies and dweet.io are in no way affiliated. Dweet.io is a free, hosted service that fulfills the same role as your server would. If you already have a hosted HTTPS POST endpoint set up, feel free to edit the Data Connector to point toward your server instead.

Name the new Data Connector "dweet.io".

The Endpoint URL needs to be of the format https://dweet.io/dweet/for/UNIQUE-NAME-HERE, where the all-caps part needs to be unique. For example, use today’s date and append your name, e.g. https://dweet.io/dweet/for/2020-02-01-company-quickstart.

Next, press SAVE NEW DATA CONNECTOR. 

View real-time events

Go to https://dweet.io/follow/UNIQUE-NAME-HERE (note the slightly different URL) and select the Raw tab.

Touch one of the sensors in the project and watch events appear here!

Note that, if you have not touched any sensors yet, you will receive an error saying: The thing is not a thing. If you do, just press your sensors and refresh the page.

Success!

Congratulations, you have now successfully integrated your sensors with a third party service!

What's next?

  • In our Interactive API Reference, you can explore and test much of the functionality of the API without writing a single line of code.
  • You can also look at this simple Code Example, which sets up a new project, a service account, and a small Python client. The client will list all devices in your Inventory Project and listen to real-time events from those devices.