copyapi

Copy.com API Node.js Client Library

Welcome to the official Copy.com Node.js Client Library!

Status

This client library is currently in extremely early stages, and is not ready for production. For a list of all the things wrong, check out the list of Issues.

Once we hit version 0.3.0, it will be safe to use this Client Library in your projects.

Installation

$ npm install copyapi

Example Usage

var express = require('express');
var app = express();
var copyapi = require('copyapi');
var port = 3000;

// Enabling Express.js sessions, which rely on a coookie
app.use(express.cookieParser('SupERseCREt'));
app.use(express.session());

// Setting the consumer key, consumer secret, and callback URL
copyapi.configure({
	consumer_key: 'CoNsumERkEy',
	consumer_secret: 'ConSUMerSecREt',
	callback_url: 'http://localhost:' + port + '/get_access_token',
});

// Landing page
app.get('/', function(req, res) {
	console.log("GET /");

	res.send('<a href="/get_request_token">Get Request Token</a>');
});

// Gets a request token, then redirects user to authorize screen
app.get('/get_request_token', function(req, res) {
	console.log("GET /get_request_token");

	copyapi.getRequestToken(function(error, request_pair, redirect_url) {
		if (error) { res.send("ERROR GETTING REQUEST TOKEN:\n" + error); return; }

		// Store the Request Token and Request Secret in the users session
		req.session.request_pair = request_pair;

		console.log("REQUEST TOKEN: " + request_pair.token + "\nREQUEST SECRET: " + request_pair.secret);

		res.redirect(redirect_url);
	});
});

// Third party redirects user back to this page, where we then request an access token
app.get('/get_access_token', function(req, res) {
	console.log("GET /get_access_token");

	copyapi.getAccessToken(req.session.request_pair, req.query.oauth_verifier, function(error, access_pair) {
		if (error) { res.send("ERROR GETTING AT" + error); return; }

		console.log("ACCESS TOKEN: " + access_pair.token + "\nACCESS TOKEN SECRET: " + access_pair.secret);

		// We no longer need these request details, so lets delete them
		delete req.session.request_pair;

		// Storing the Access Token and Access Secret in the users session
		req.session.access_pair = access_pair;

		res.send('Done getting Access Token!<br />\n<a href="/api_call_get_user">Make an API Call</a>');
	});
});

// Here we make a sample API call
app.get('/api_call_get_user', function(req, res) {
	console.log("GET /api_call_get_user");

	copyapi.getUser(req.session.access_pair, function(error, user, code) {
		if (error) { res.send("ERROR TALKING TO API:\n" + error); return; }

		res.send(
			"Name: " + user.first_name + " " + user.last_name + "<br />\n" + 
			"Usage: " + ((user.storage.used / user.storage.quota) * 100).toFixed(2) + "%<br />\n"
		);
	});
});

app.get('/api_call_set_user/:first_name/:last_name', function(req, res) {
	console.log("GET /api_call_set_user");
	console.log("FIRST_NAME: " + req.params.first_name);
	console.log("LAST_NAME: " + req.params.last_name);

	copyapi.setUser(req.session.access_pair, req.params.first_name, req.params.last_name, function(error, user, code) {
		if (error) { res.send("ERROR TALKING TO API:\n" + error); return; }

		res.send(
			"Name: " + user.first_name + " " + user.last_name + "<br />\n"
		);
	});
});

app.get('/api_call_get_path/*', function(req, res) {
	console.log("GET /api_call_get_path");
	console.log("PATH: " + req.params[0]);

	copyapi.getPath(req.session.access_pair, req.params[0], function(error, data) {
		if (error) { res.send("ERROR TALKING TO API:\n" + error); return; }

		res.send(data);
	});
});

app.get('/api_call_get_inbox/*', function(req, res) {
	console.log("GET /api_call_get_inbox");
	console.log("PATH: " + req.params[0]);

	copyapi.getInbox(req.session.access_pair, req.params[0], function(error, data) {
		if (error) { res.send("ERROR TALKING TO API:\n" + error); return; }

		res.send(data);
	});
});

app.listen(port);

License

BSD