EVRYTHNG Developer Hub

Welcome! Here's where you'll find what you need to start working with EVRYTHNG as quickly as possible. There are comprehensive guides, documentation, and support if you get stuck. We encourage you to dive in and explore.

Create Free Account Read Documentation

Authentication

Access to our API is achieved via HTTPS requests to the https://api.evrythng.com domain. Unencrypted HTTP requests are accepted via http://api.evrythng.com for low-power devices without SSL support, but we strongly recommend using only HTTPS if you store any valuable or sensitive data in our platform. Every request to our API must (unless otherwise stated) contain a valid API key in the Authorization HTTP header to identify the user or application issuing the request and execute it if authorized.

Here is an example of a request to our API that returns the list of all the Thngs you have created. Note the appropriate use of the Authorization header.

curl -i -H "Accept: application/json" \
  -H "Authorization: $APP_USER_API_KEY" \
  -X GET "https://api.evrythng.com/thngs"

To make it easier for developers using embedded platforms, instead of sending the API key in the Authorization header, you can simply append ?access_token=$APP_USER_API_KEY to any URL in the API. This request is equivalent to the one above:

curl -i -H "Accept: application/json" \
  -X GET "https://api.evrythng.com/thngs?access_token=$APP_USER_API_KEY"

For JavaScript developers evrythng.js (or evrythng-extended.js) makes it easier by only requiring you to initialise a scope object with the right API key:

var operator = new EVT.Operator(OPERATOR_API_KEY);
operator.thng().read().then(function(thngs) {
  console.log(thngs);
});

Note

The EVT.Operator scope is only supported with the evrythng-extended.js JavaScript SDK.


Applications

Within your user account, you can setup several applications, each with its own API key. Note that the data created within an application will not be visible by another application unless you specify it at creation time.

Beware!

Your Operator API key allows any software/devices to connect to your account and modify or delete all the data you have created, so keep it safe just as you do with your login and password. If you think one of your access tokens might have been compromised, you can disable it and generate a new one from the account settings page.

Authentication