EVRYTHNG Client Javascript SDK (Extended)

evrythng-extended.js is an extended version of evrythng.js that adds Operator administrative capabilities (read about Scope and Permissions). This means you need your Account Operator API key, which you can find in your Account settings page.

evrythng-extended.js can be used both in Web applications (Browser) and embedded/server applications using Node.js. The difference being the transport layer - Browser's XHR vs Node's HTTP.

evrythng-extended.js is intended for administrative operations only - the same sort of actions you would do on the EVRYTHNG Dashboard. Be sure to never include your EVRYTHNG Operator API key in any public source code (read more about Scope Permissions). You can use it in a server-side application or if you dynamically retrieve the Operator API key from a server call.

See Related Tools below for other usages.

Installation

Node.js

npm install evrythng-extended --save

Browsers

Note: Most Web Applications will not need the extended features and should use the core version of evrythng.js instead.

With Bower

bower install evrythng-extended --save

The Bower package is AMD-compatible. This means you can load it asynchronously using tools like Require.js or simply dropping the script tag into your HTML page:

<script src="bower_components/evrythng-extended/dist/evrythng-extended.js"></script>

See Usage below for more details.

Load from CDN

Add the script tag into your HTML page:

<script src="//cdn.evrythng.com/toolkit/evrythng-js-sdk/evrythng-extended-4.7.2.min.js"></script>

Or always get the latest release (warning, new releases might break your code!):

<script src="//cdn.evrythng.com/toolkit/evrythng-js-sdk/evrythng-extended.js"></script>
<script src="//cdn.evrythng.com/toolkit/evrythng-js-sdk/evrythng-extended.min.js"></script>

For HTTPS you need to use:

<script src="//d10ka0m22z5ju5.cloudfront.net/toolkit/evrythng-js-sdk/evrythng-extended-4.7.2.min.js"></script>
<script src="//d10ka0m22z5ju5.cloudfront.net/toolkit/evrythng-js-sdk/evrythng-extended.js"></script>
<script src="//d10ka0m22z5ju5.cloudfront.net/toolkit/evrythng-js-sdk/evrythng-extended.min.js"></script>

Usage

evrythng-extended.js works exactly the same way as evrythng.js, just with more resources (endpoints). See all Operator permissions in API key permissions and the usage examples in evrythng.js documentation.

Note: DO NOT include your Operator API Key in any public code. This includes committing to any public repositories (GitHub, BitBucket, etc.). If you have done so, you can reset your key in your Account settings page.

For advanced usage and options, see Documentation below.

Node.js

var EVT = require('evrythng-extended');

// Initialise Operator Scope
var operator = new EVT.Operator(OPERATOR_API_KEY);
...

// Or with Trusted App Scope
var app = new EVT.TrustedApp(TRUSTED_APP_API_KEY);

RequireJS (AMD)

requirejs.config({
  paths: {
    'evrythng-extended': '../bower_components/evrythng-extended/dist/evrythng-extended'
  }
});
    
require(['evrythng-extended'], function (EVT) {

  var operator = new EVT.Operator(OPERATOR_API_KEY);
  ...

});

Globals

If you aren't using any of the above script loading mechanisms, the EVT module is available as a browser global (EVT):

var operator = new EVT.Operator(OPERATOR_API_KEY);
...

Examples

General

Read all Thngs in your account (not scoped):

operator.thng().read().then(function(thngs){
  console.log(thngs);
  
  // Delete a Thng
  thngs[0].delete();
});

Create an action type:

operator.actionType().create({
  name: '_orderPizza',
  customFields: {
    displayname: 'Order Pizza Now!'
  }
});

Read default redirection of a Thng:

EVT.api({
  apiUrl: 'https://tn.gg',
  url: '/redirections',
  params: {
    evrythngId: '12345'
  },
  authorization: OPERATOR_API_KEY
}).then(function(redirections){
  console.log(redirections);
});

Get QR code:

EVT.api({
  apiUrl: 'https://tn.gg',
  url: '/1234.png',
  headers: {
    accept: 'image/png'
  }
});

Documentation

The EVRYTHNG API has evrythng.js examples whenever applicable. If you'd like to see what's going on under the hood, check out the Annotated Source.

Source Maps

Source Maps are available, which means that when using the minified version, if you open Developer Tools (Chrome, Safari, Firefox), .map files will be downloaded to help you debug code using the original uncompressed version of the library.

Related tools

evrythng.js

evrythng.js is the core version of evrythng.js intended to be used in public applications and/or devices.

evrythng-scan.js

evrythng-scan.js is an evrythng.js plugin that lets you identify Products and Thngs right from your browser, without using a standalone QR Code scanning app. It also supports Image Recognition.

evrythng-mqtt.js

evrythng-mqtt is an evrythng.js plugin for Node.js that adds support for real-time MQTT methods to any resource.

evrythng-hub.js

evrythng-hub is an evrythng.js plugin for both Browser and Node.js that adds smart routing of local requests when in the context of a Thng-Hub Gateway.

License

Apache 2.0 License, check LICENSE.txt

Copyright (c) EVRYTHNG Ltd.