A lightweight API that leverages the asynchronous nature of node.js to interface with flickr.
The API should be compatible with the actual Flickr API as documented here (http://www.flickr.com/services/api/). There are also some utility methods implemented that enable easier usage of the responses and for helping with the authentication model.
When constructing API calls that require no authentication (or no signing) then the simplest instantiation of the FlickrAPI should be used for example:
var FlickrAPI= require('flickr').FlickrAPI;
var sys= require('sys');
var flickr= new FlickrAPI(your_api_key_here);
// Search for photos with a tag of 'badgers'
flickr.photos.search({tags:'badgers'}, function(error, results) {
sys.puts(sys.inspect(results));
});
As flickrnode uses the node.js idiom of accepting a final callback/handler function as the final argument of any asynchronous method, error handling is as simple as testing for the presence of the first argument when this callback is executed. If present the first argument will be an object literals consisting of a code and a message, the values of these properties are documented on flickr's API pages e.g.:
var FlickrAPI= require('flickr').FlickrAPI;
var sys= require('sys');
var flickr= new FlickrAPI(your_api_key_here, your_shared_secret_key);
// Get hold of a 'frob' (requires the method to be signed, does not require authentication)
flickr.auth.getFrob(function(error, frob) {
if( error ) fail(error);
else sys.puts("FROB: "+ sys.inspect(frob));
});
// Simply print out the error
function fail (err) {
sys.puts("ERR: " + err.code + " - " + err.message);
};
When executing methods that require signing (and for methods that require authentication) you must also provide your 'shared secret key':
var FlickrAPI= require('flickr').FlickrAPI;
var sys= require('sys');
var flickr= new FlickrAPI(your_api_key_here, your_shared_secret_key);
// Get hold of a 'frob' (requires the method to be signed, does not require authentication)
flickr.auth.getFrob(function(error, frob) {
sys.puts("FROB: "+ sys.inspect(frob));
});
Some methods require the API calls to have been previously authenticated, the process of authentication is non-sequential and involves the end-user, for details of how to properly implement this please see: http://www.flickr.com/services/api/auth.spec.html The relevant code snippets follow:
var FlickrAPI= require('flickr').FlickrAPI;
var sys= require('sys');
var flickr= new FlickrAPI(your_api_key_here, your_shared_secret_key);
flickr.getLoginUrl("read", null, function(error, url, frob) {
// Make a note of the frob and inform the user they need to visit the url passed in here. ......
});
Please note this method consumes the passed frob and should only be called once per session. var FlickrAPI= require('flickr').FlickrAPI; var sys= require('sys'); var flickr= new FlickrAPI(your_api_key_here, your_shared_secret_key);
flickr.auth.getToken(frob, function(error, res){
// Make a note res.token as this is what you will be using everywhere else.
});
var FlickrAPI= require('flickr').FlickrAPI;
var sys= require('sys');
var flickr= new FlickrAPI(your_api_key_here, your_shared_secret_key, authentication_token);
// This method requires authentication
flickr.blogs.getList(function(error, blogs) {
sys.puts(sys.inspect(blogs));
});
var FlickrAPI= require('flickr').FlickrAPI;
var sys= require('sys');
var flickr= new FlickrAPI(your_api_key_here, your_shared_secret_key);
flickr.setAuthenticationToken(authentication_token);
// This method requires authentication
flickr.blogs.getList(function(error, blogs) {
sys.puts(sys.inspect(foo));
});