imgur-v2 v0.2.1

imgur-v2

Since the original publisher seems te be inactive I have created this fork without the CLI support but with new features.

Original package node-imgur

Module Usage

Installation

npm install imgur-v2

Usage

Requiring the module:

var imgur = require('imgur-v2');

Dealing with client IDs:

// Setting
imgur.setClientId('aCs53GSs4tga0ikp');

// Getting
imgur.getClientId();

// Saving to disk. Returns a promise.
// NOTE: path is optional. Defaults to ~/.imgur
imgur.saveClientId(path)
    .then(function () {
        console.log('Saved.');
    })
    .catch(function (err) {
        console.log(err.message);
    });


// Loading from disk
// NOTE: path is optional. Defaults to ~/.imgur
imgur.loadClientId(path)
    .then(imgur.setClientId);

Dealing with API URL:

In order to change the API Url say Mashape URL, use setAPIUrl(MashapeURL)

//Setting
imgur.setAPIUrl('https://api.imgur.com/3/');

//If setAPIUrl() is not called, API URL is read from process.env.IMGUR_API_URL

//Getting
imgur.getAPIUrl();

Dealing with Mashape Key

Requests to the Mashape URL expects a X-Mashape-Key: MashapeKey header. Set Mashape Key by using setMashapeKey(MashapeKey) method. Note: Defaults to process.env.IMGUR_MASHAPE_KEY

//Setting
imgur.setMashapeKey(https://imgur-apiv3.p.mashape.com/);

//Getting
imgur.getMashapeKey()

Dealing with credentials:

For when you want to upload images to an account.

// Setting
imgur.setCredentials('email@domain.com', 'password', 'aCs53GSs4tga0ikp');

Uploading files; globbing supported:

// A single image
imgur.uploadFile('/home/kai/kittens.png')
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });

// All jpegs in a specific folder
// to an album you own
var albumId = 'F8KTV';
imgur.uploadFile('/home/kai/*.jpg', albumId)
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });

// Multiple image types from home folder
imgur.uploadFile('~/*.(jpg|png|gif)')
    .then(function(json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Fetching image data:

var kittenPic = 'mbgq7nd';
imgur.getInfo(kittenPic)
    .then(function(json) {
        console.log(json);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Fetching album data:

var kittenAlbum = 'mbgq7nd';
imgur.getAlbumInfo(kittenAlbum)
    .then(function(json) {
        console.log(json);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Creating an album:

imgur.createAlbum()
    .then(function(json) {
        console.log(json);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Uploading URLs of images hosted elsewhere:

// Include http(s) when specifying URLs
imgur.uploadUrl('https://octodex.github.com/images/topguntocat.png')
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Uploading Base-64 encoded images:

var imgurFavicon = 'iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAmUlEQVQ4je2TsQ3CMBBFnxMa08WR2IQKJskIUNwMZAcYwWIQMs65JCUpEEIYW4pJy6v+6e6+/hVnnGsAzsCBMi7AsbbW/rIMsAU2xrnmkeruuzW7zgIw+JGbv6fGQpWzfy3HOsJlDQY/AlCv3jpF9oS5ZBOICKoB1YCIlCdQDR9127qyBHP5Gyw3CBXPr/qi709JHXE1S995AsqoJu8x78GsAAAAAElFTkSuQmCC';

imgur.uploadBase64(imgurFavicon)
    .then(function (json) {
        console.log(json.data.link);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Uploading multiple images:

Upload an array of images of the desired upload type ('File', 'Url', 'Base64').

Returns an array of images (imgur image data).

imgur.uploadImages(images, uploadType /*, albumId */)
    .then(function(images) {
        console.log(images);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Uploading an album:

Create a new album and upload an array of images of the desired upload type to it ('File', 'Url', 'Base64').

Returns an object with the album data and an array of images { data: {...}, images: {...}, ...}.

The third parameter is an optional fail safe, meaning if the array of images is empty or invalid, it will not fail, but returns an object with empty data and empty images.

imgur.uploadAlbum(images, uploadType /*, failSafe */)
    .then(function(album) {
        console.log(album.data, album.images);
    })
    .catch(function (err) {
        console.error(err.message);
    });

Deleting anonymous uploads

Delete an image based on the deletehash(generated during the image upload)

imgur.deleteImage(deletehash)
    .then(function(status) {
        console.log(status);  
    })
    .catch(function(err) {
        console.error(err.message);
    });

License

MIT