smartimage

A JavaScript client for Smartimage

node-smartimage

A JavaScript client for Smartimage. Works in node and in the browser!

(Note: It technically works in the browser only if you turn off CORS or use a proxy like corsproxy to bypass CORS restrictions for now.)

Documentation


Quickstart

Just set your options up like below including the username and password. Currently only basic authentication is supported by Smartimage's API.

All API methods are documented at Apiary. All API methods are supported except for file uploads (which are planned for a future release).

var smartimage = require('./index');
 
var options = {
    protocol: 'https',
    host: 'my.smartimage.com',
    auth: {
        type: 'basic',
        username: process.env.SI_USERNAME,
        password: process.env.SI_PASSWORD
    }
};
 
smartimage('GET', '/collections', query, options, function(err, res){
        console.log(res);
});

Asynchronous Response Handling

Responses can be handled using promises thanks to then/promise.

// Promise
var success = function(res) {
    console.log("Promise success!");
};
 
var failure = function(err){
    console.log("Promise fail!");
}
 
var query = null;
smartimage('GET', '/collections', query, options).then(success, failure);

Responses can also be handled using nodejs style callbacks:

// Callback
var cb = function(err, res){
    console.log("Callback success!");
};
 
var query = null;
smartimage('GET', '/collections', query, options, cb);

Types of Results

The library can also return the response body in different ways. You can use any of the following with callbacks or promises as well.

Receive a Stream of Data

By default, the response object passed into a successful promise or callback is an instance of an http.IncomingMessage and, as such, the response body is a stream.Readable.

smartimage('GET', '/collections', null, options, cb);

Receive a Buffer of Data

You can also receive a Buffer of response data using the buffer() method.

smartimage.buffer('GET', '/collections', null, options, cb);

JSON data can be returned using the json() method:

// JSON Callback
var cb = function(err, res){
    console.log(res.body)
};
 
var query = null;
smartimage.json('GET', '/collections', query, options, cb);
// JSON Promise
var success = function(res) {
    console.log(res.body);
};
 
var query = null;
smartimage.json('GET', '/collections', query, options).then(success);