EVRYTHNG Developer Hub

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

Suggest Edits

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.

Authenticating Requests

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: $APPLICATION_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=$APPLICATION_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=$APPLICATION_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:

const operator = new EVT.Operator(OPERATOR_API_KEY);

operator.thng().read().then(console.log);

Note

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

Authentication