Building your own web app

For most connected products, the heart of the customer experience lies with the hardware device and the firmware that runs it. But to unlock the true potential of the internet of things, to create a valuable, maybe even magical experience for your customers, there need to be capabilities that rely on the power of the internet.

How do you surprise and delight your customers? You want them to think, “Wow! How is that possible?” How do you take deeply complex data from around the internet and make a product that “just works” even though it shouldn't at that price point?

You do the hard work on a server, keeping the device simple.

(Back when we used to be named Spark, we made a fun video to help explain this.)

Our REST API allows you easily to build web services that interact with your products in real time. You can build these web services in any programming language (JavaScript/Node.js, Ruby, Python, C#, PHP, etc.), although we provide the most support for JavaScript/Node.js through our ParticleJS JavaScript SDK. If you are interested in libraries for interacting with our API in other programming languages, please search our forum for community-generated libraries.

You have already learned a lot about what you'll need to do to build your web application in the last section on Authentication & Security. This section will focus more specifically on building web applications.

Collecting data through webhooks or an event stream

Imagine you're making a social game that creates a live feed of pictures as customers use your product. Each time a customer hits a physical button on the hardware product, a picture is added to a Twitter-like timeline. To accomplish this, you will listen to the events published by all your products in customers' hands all over the world.

There are two ways to do this.


Webhooks are well-understood and easy to set up. You write your web app with a URL that Particle servers will call whenever one of your products publishes an event.

You make a single Particle API call to create the webhook, and from that moment on, events matching your webhook will trigger our servers to call your web app.

Check out our Webhooks Guide for more information.

While easy to understand and set up, webhooks at scale might require some considerations. Each triggering of a webhook causes a request to be sent, so make sure your app can handle the traffic. For example, a small beta run of 1000 devices, each publishing once a minute might cause anywhere from 17 to 1000 requests in a given second, depending on how the publishes line up. Webhooks will support some basic queuing and smoothing to help address bursts like this, and a number of cloud hosting providers offer data ingestion services that can handle continuous heavy streams and bursts of requests (Azure, AWS).

Event streams

If you've created an app that subscribes to Twitter's streaming API, you'll feel right at home with the other solution. Your server can subscribe to a single stream of server-sent events that will efficiently transport all the data your products can publish without all the HTTP overhead for every event.

Check out our API reference on subscribing to event streams for more information.

When deploying on Heroku, you'll need to create worker process to listen to the event stream. Here are some links to help out.


Initiating device behavior by calling functions

Now imagine you want a customer's device to dance rainbows when someone likes a picture they've posted. The web app will need to hit the Particle API to call a function on one device to cause it to dance rainbows.

What's next?

We can't wait to show you just how easy it is to build a web app for your product on Particle!

If your product is better suited for a mobile app, you will want to build your iOS and Android mobile apps using our mobile SDKs.