Flickr::API.3pm

Langue: en

Version: 2009-07-31 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Flickr::API - Perl interface to the Flickr API

SYNOPSIS

   use Flickr::API;
 
   my $api = new Flickr::API({'key'    => 'your_api_key',
                              'secret' => 'your_app_secret'});
 
   my $response = $api->execute_method('flickr.test.echo', {
                 'foo' => 'bar',
                 'baz' => 'quux',
         });
 
 

or

   use Flickr::API;
   use Flickr::API::Request;
 
   my $api = new Flickr::API({'key' => 'your_api_key'});
 
   my $request = new Flickr::API::Request({
                 'method' => 'flickr.test.echo',
                 'args' => {},
         });
 
   my $response = $api->execute_request($request);
 
 

DESCRIPTION

A simple interface for using the Flickr API.

"Flickr::API" is a subclass of LWP::UserAgent, so all of the various proxy, request limits, caching, etc are available.

METHODS

execute_method($method, $args)
Constructs a "Flickr::API::Request" object and executes it, returning a "Flickr::API::Response" object.
execute_request($request)
Executes a "Flickr::API::Request" object, returning a "Flickr::API::Response" object. Calls are signed if a secret was specified when creating the "Flickr::API" object.
request_auth_url($perms,$frob)
Returns a "URI" object representing the URL that an application must redirect a user to for approving an authentication token.

For web-based applications $frob is an optional parameter.

Returns undef if a secret was not specified when creating the "Flickr::API" object.

AUTHOR

Copyright (C) 2004-2005, Cal Henderson, <cal@iamcal.com>

Auth API patches provided by Aaron Straup Cope

SEE ALSO

Flickr::API::Request, Flickr::API::Response, XML::Parser::Lite, <http://www.flickr.com/>, <http://www.flickr.com/services/api/>