REST API

Our REST API provides programmatic access to authenticate applications, create/retrieve a thing, post alert/feed messages, update status variables, and send/receive commands. All responses are returned in a consistent JSON format making it easy to parse data and catch errors.

Our Philosophy

The purpose of the API is to be as intuitive as possible and to stay out of your way. API’s should always just work and we have made that our priority. All major functionality is built in, so if you choose not to use one of our libraries you can still harness all of the power of Thingdom by making simple REST calls.

cURL Example

Below is a complete example of how to get up and running with Thingdom using simple HTTP calls via cURL. To experience the magic of Thingdom go ahead and sign-up for (completely free) API access, then download the mobile application (Android / iOS) and start hacking!

// Authenticate and get back APPLICATION_TOKEN
curl -X POST -H 'Content-Type: application/json' -d "{\"api_secret\":\"API_SECRET\"}" https://api.thingdom.io/1.1/token

// Get Thing Information (Including THING_ID)
curl -X POST -H 'Content-Type: application/json' -d "{\"token\":\"APPLICATION_TOKEN\", \"product_type\":\"video\", \"name\":\"My Video App\"}" https://api.thingdom.io/1.1/thing

// Post Feed
curl -X POST -H 'Content-Type: application/json' -d "{\"token\":\"APPLICATION_TOKEN\", \"thing_id\":THING_ID, \"feed_category\":\"render_start\", \"message\":\"Rendering started.\"}" https://api.thingdom.io/1.1/feed

// Post Status
curl -X POST -H 'Content-Type: application/json' -d "{\"token\":\"APPLICATION_TOKEN\", \"thing_id\":THING_ID, \"status_array\" : [{\"name\":\"render_status\", \"value\":50}]}" https://api.thingdom.io/1.1/status

Get Started

Don’t take our word for it — see what you can do with Thingdom yourself!